AI agents
Claude for Mac
Ask Claude about every inbox you have. Glassmail adds itself to Claude’s settings with one click.
This is the short version. How to connect Claude to your email on a Mac explains how it works and what Claude can see, and 30 things to ask Claude about your email has prompts to start with.
What you’ll need
- Claude for Mac, signed in.
- Glassmail with your accounts added.
Steps
- In Glassmail, open Settings › Agents and turn on Allow AI agents to read my mail.
- Click Set Up next to Claude for Mac. It changes to Connected.
- Quit Claude completely (Claude › Quit Claude, or ⌘Q) and open it again. Closing the window isn’t enough.
- In a new chat, ask “Summarise my email from the past week.” The first time, Claude asks to use Glassmail’s tools. Allow them.
Setting it up by hand
If you’d rather edit the file yourself, open Claude › Settings › Developer › Edit Config and add Glassmail under mcpServers:
{
"mcpServers": {
"glassmail": {
"command": "/Applications/Glassmail.app/Contents/MacOS/Glassmail",
"args": ["--mcp"]
}
}
}
If the file already lists other servers, add the “glassmail” entry next to them inside the same mcpServers. Use the path to wherever Glassmail is; Settings › Agents › ··· › Copy Configuration gives the right one.
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.
If it doesn’t work
Claude doesn’t list any Glassmail tools
- Quit Claude with ⌘Q and open it again. Claude reads its server list only when it starts. Claude’s own log of these servers is in ~/Library/Logs/Claude/.
- In Glassmail, open Settings › Agents and check that Allow AI agents to read my mail is on and that Claude says Connected.
- If Claude 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
How do I connect Claude to my email on a Mac?
Install Glassmail and add your accounts. In Glassmail › Settings › Agents, turn on “Allow AI agents to read my mail” and click Set Up next to Claude for Mac. Restart Claude, then ask it about your mail.
Does this work with Gmail, iCloud and Outlook in Claude?
Yes. Claude reads whatever Glassmail has: Gmail and Google Workspace, iCloud, Outlook and Microsoft 365, Yahoo, Fastmail and any IMAP account, all through one connection.
Where does Glassmail add itself in Claude’s settings?
In ~/Library/Application Support/Claude/claude_desktop_config.json, as an entry called “glassmail” under mcpServers. Glassmail backs the file up first and changes nothing else in it.