Glassmail

AI agents

Claude Code

One command in Terminal, or one click in Glassmail. Claude Code can then search and read your mail in any project.

All setup guides

Steps

  1. In Glassmail, open Settings › Agents and turn on Allow AI agents to read my mail.
  2. Click Set Up next to Claude Code. Glassmail runs Claude Code’s own claude mcp add command for you.
  3. Start a new Claude Code session. /mcp lists glassmail with its tools.

Or in Terminal

claude mcp add --scope user glassmail -- /Applications/Glassmail.app/Contents/MacOS/Glassmail --mcp

--scope user makes it available in every project. To remove it: claude mcp remove --scope user glassmail.

Good uses in the terminal

What the agent can do

What stays private

If it doesn’t work

Claude Code 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 add an email MCP server to Claude Code?

With Glassmail installed, run claude mcp add --scope user glassmail -- /Applications/Glassmail.app/Contents/MacOS/Glassmail --mcp, or click Set Up next to Claude Code in Glassmail › Settings › Agents. Then start a new session.

Can Claude Code read my email attachments?

It can find attachments and read the text of PDFs, Word documents, CSV and text files, up to 20,000 characters each, while Glassmail is open. It never receives the raw file.

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