AI agents
Use Claude, Codex, Cursor and other AI agents with your email
Let the AI app you already use search and read your mail on your Mac. It can ask to tidy up, but never sends or deletes.
Glassmail includes an MCP server: a small program the AI apps on your Mac start when they want to look at your mail. It reads the mail Glassmail has already downloaded, from all your accounts, and answers the agent’s questions. Nothing goes to Glassmail, and there’s no account to make. Email MCP servers for Mac compares this with the other ways to give an AI app your mail.
Supported AI apps
Glassmail sets these up with one click, in onboarding or later in Settings › Agents:
- Claude for Mac (or the longer walkthrough, how to connect Claude to your email on a Mac)
- Claude Code
- Codex CLI
- Cursor
- VS Code (Copilot agent mode), Windsurf and Gemini CLI: the same Set Up button
- Any other app that runs local MCP servers: Copy Configuration under “Another agent”
Set it up
- Open Glassmail › Settings › Agents and turn on Allow AI agents to read my mail. It’s off until you do.
- Click Set Up next to your AI app. Glassmail adds a “glassmail” entry to that app’s own MCP settings and changes nothing else. It keeps a backup of the file first.
- Restart the AI app so it picks up the new server.
- Ask it something about your mail.
Setting up Glassmail for the first time? The “AI that stays on your Mac” step lists the AI apps it finds on your Mac, each with a switch. They all start off.
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.
Things to ask
- “Summarise my email from the past two weeks. What needs me?”
- “Who hasn’t replied to me?”
- “What did Sara and I talk about last month?”
- “Find the Stripe invoice PDF from October and tell me the amount.”
- “What deadlines do I have in the next two weeks?”
- “What can I archive?” and then “Archive the newsletters from that list.”
There are 30 more in 30 things to ask Claude about your email.
For a summary of any stretch of time, the agent is told to use Glassmail’s overview tool first. It covers the whole range at once, with totals, the busiest senders and what needs you, so the summary isn’t built from the 20 newest emails.
Built-in AI or your own AI app?
Glassmail’s built-in assistant runs on your Mac with Apple Intelligence or a downloaded model, and sends nothing anywhere. It’s good for quick questions and summaries. A large model in Claude or Codex goes further: longer summaries, comparing many threads, working with your other tools. When you ask Glassmail’s assistant something broad, like a summary of the past two weeks, it offers Ask Claude for a deeper answer if you’ve connected one. More in Local AI or Claude for your email.
If it doesn’t work
The AI app doesn’t list any Glassmail tools
- Quit the AI app completely and open it again. Most read their MCP settings only when they start.
- In Glassmail, open Settings › Agents and check that Allow AI agents to read my mail is on and that The AI app says Connected.
- If The AI app 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.
Frequently asked questions
Which AI apps can read my email through Glassmail?
Any app that supports local MCP servers. Glassmail sets up Claude for Mac, Claude Code, Codex CLI, Cursor, VS Code, Windsurf and Gemini CLI with one click, and gives a configuration to paste into any other.
Can an AI agent send or delete my email through Glassmail?
No. Glassmail has no tool that sends or deletes mail. If you allow changes, an agent can ask to archive, mark as read, star, snooze or save a draft, and Glassmail asks you to allow or deny each request.
Does my email go to the AI company when I use an agent?
The mail the agent reads goes to that agent’s AI provider, such as Anthropic for Claude. Glassmail itself sends nothing anywhere, and its built-in AI runs on your Mac. You can hide accounts, folders and senders from agents.
Does Glassmail need to be open for an agent to read my mail?
No. Agents read the mail Glassmail has already downloaded, even with Glassmail closed. Changes, attachments and emails whose text hasn’t downloaded yet need Glassmail open.