Glassmail

AI agents

Claude for Mac

Ask Claude about every inbox you have. Glassmail adds itself to Claude’s settings with one click.

All setup guides

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

Steps

  1. In Glassmail, open Settings › Agents and turn on Allow AI agents to read my mail.
  2. Click Set Up next to Claude for Mac. It changes to Connected.
  3. Quit Claude completely (Claude › Quit Claude, or ⌘Q) and open it again. Closing the window isn’t enough.
  4. 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

What stays private

Things to ask

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

“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.

Other guides

Glassmail is downloading

  1. 1Open Glassmail.dmg from your Downloads (bottom right of the Dock, or in Finder › Downloads).
  2. 2In the window that opens, drag Glassmail onto the Applications folder.
  3. 3Open Glassmail from Applications or Launchpad, and click Open if your Mac asks.

Download didn’t start? Try again · Step-by-step install guide