AI agents
Cursor
Bring bug reports and client emails into Cursor’s agent without copying and pasting.
Steps
- In Glassmail, open Settings › Agents and turn on Allow AI agents to read my mail.
- Click Set Up next to Cursor. Glassmail adds itself to
~/.cursor/mcp.json, after backing the file up. - Restart Cursor. In Cursor’s MCP settings, glassmail should be listed and switched on.
- In the agent chat, ask “Find the bug report about the login page from this week and summarise it.”
Setting it up by hand
{
"mcpServers": {
"glassmail": {
"command": "/Applications/Glassmail.app/Contents/MacOS/Glassmail",
"args": ["--mcp"]
}
}
}
VS Code and Windsurf work the same way; Glassmail’s Set Up button writes the right file for each (VS Code calls the key servers).
What the agent can do
- Read: search every account, list unread mail, summarise a week or a month with the
overviewtool, read whole conversations, find attachments and read the text of PDFs, Word files and spreadsheets, list who emails you most, find dates and deadlines in your mail, and see what changed since it last looked. - Change, only if you allow it: archive, mark as read, star, snooze, and save a draft for you to send. These are off until you turn on Let AI agents make changes (always asks first) in Settings › Agents. Each request then opens a panel in Glassmail, “Claude wants to archive 14 conversations”, with the list and Allow, Deny or Allow for This Session. Every change is listed in Settings › Agents with Undo.
- Never: send an email or delete one. Glassmail has no tool for either.
What stays private
- Glassmail itself sends nothing anywhere. The agent reads your mail through Glassmail on your Mac.
- The mail an agent reads goes to that agent’s AI provider (Anthropic for Claude, OpenAI for Codex, and so on), under that provider’s privacy terms. Glassmail’s own built-in AI is different: it runs on your Mac and sends nothing.
- In Settings › Agents, under Hide from agents, you can hide whole accounts, folders and senders. Junk, Trash and Drafts are hidden from the start. Hidden mail never reaches an agent, not even in counts.
- Glassmail tells the agent that email content is untrusted and must never be followed as instructions, and marks where each email’s text starts and ends.
If it doesn’t work
Cursor doesn’t list any Glassmail tools
- Restart Cursor, then check its MCP settings that glassmail is switched on.
- In Glassmail, open Settings › Agents and check that Allow AI agents to read my mail is on and that Cursor says Connected.
- If Cursor says Set up for another copy of Glassmail, Glassmail was moved or reinstalled. Click Update.
“Glassmail isn’t sharing mail right now”
Turn on Allow AI agents to read my mail in Glassmail › Settings › Agents.
“Glassmail isn’t open”
Reading works with Glassmail closed. Changing mail, downloading an email whose text hasn’t arrived yet, and reading an attachment need Glassmail open, because Glassmail does those, not the agent.
The agent can’t find mail you know is there
Check Hide from agents in Settings › Agents. Mail in a hidden account, folder or from a hidden sender is left out of every answer.
Still stuck? Write to hi@glassmail.app and a person replies, usually within a day. Never send us a password.