Glassmail

How to connect Claude to your email on a Mac (Gmail, iCloud, Outlook and more)

Let Claude search, read and summarise every inbox you have, from one connection on your Mac. Setup in two minutes, plus what to ask it.

· By

Summarize this post withChatGPTClaudePerplexityAI ModeGrok

Claude is good at the parts of email that take the most time: reading a long thread, pulling a date out of an attachment, telling you what a fortnight of mail actually needs from you. What it can’t do on its own is see your inbox.

The standard way to give it that view is an MCP server (the options compared): a small program on your Mac that Claude starts when it wants to look something up. This guide uses the one built into Glassmail, because it covers every account in one place (Gmail, iCloud, Outlook, Yahoo, Fastmail and any IMAP mailbox) and because it never lets Claude send or delete anything.

What you need

Connect it in four steps

  1. In Glassmail, open Settings › Agents and turn on Allow AI agents to read my mail. It’s off by default.
  2. Click Set Up next to Claude for Mac. Glassmail adds one entry, called “glassmail”, to Claude’s configuration file and changes nothing else (it backs the file up first).
  3. Quit Claude completely with ⌘Q and open it again. Claude only reads its list of servers when it starts.
  4. Ask something. The first time, Claude asks for permission to use Glassmail’s tools.

If you’re setting Glassmail up for the first time, the onboarding step “AI that stays on your Mac” lists the AI apps it finds, each with a switch. They all start off.

The Claude for Mac guide has the manual configuration and what to do if the tools don’t appear.

What to ask

These are the questions that work well, and the tool Claude uses for each. There are 30 more prompts here.

Ask What happens
“Summarise my email from the past two weeks. What needs me?” Claude calls overview, which covers the whole range: totals, the ten busiest senders, then what needs you, what you’re waiting on, security notices, mail from people and a digest of the rest.
“Who hasn’t replied to me?” list_waiting: conversations where you wrote last.
“What did Sara and I talk about last month?” person finds every address Sara wrote from and lists the conversation in both directions.
“Find the Stripe invoice PDF and tell me the amount.” search_attachments, then read_attachment reads the PDF’s text (Glassmail needs to be open).
“What deadlines do I have in the next two weeks?” upcoming reads dates out of recent mail and lists only the ones still ahead, with the sentence each came from.
“What’s new since this morning?” changes_since.
“Summary of last week in my work account only.” overview with the account named.

A common problem with AI email summaries is that they’re built from the 20 newest messages, so “the past two weeks” quietly becomes “the past two days”. Glassmail’s overview tool exists to stop that, and Glassmail tells Claude to use it for any time range.

Letting Claude tidy up

Reading is all Claude can do until you turn on Let AI agents make changes (always asks first) in Settings › Agents. After that, Claude can ask to archive, mark as read, star, snooze, or save a draft for you to send yourself. Each request 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 logged in Settings › Agents with Undo. Claude can’t send or delete mail; there’s no tool for it.

A good first try: “What can I archive?”, then “Archive the newsletters on that list.” Glassmail’s list of safe-to-archive mail uses the same rules as its own assistant: never anything starred, anything from a person, a sign-in code that still works, a conversation you’re waiting on, or a fresh security notice.

What Claude sees, and where it goes

If you’d rather nothing leaves your Mac at all, Glassmail’s built-in assistant runs on Apple Intelligence or a downloaded model. Local AI or Claude for your email compares the two.

Quick answers

Can Claude read my email?

Yes, through an MCP server: a small program on your Mac that Claude starts to look things up. Glassmail includes one that covers every account you've added to it, including Gmail, iCloud, Outlook, Yahoo and any IMAP mailbox.

How do I connect Claude for Mac to my Gmail and iCloud at the same time?

Add both accounts to Glassmail, then in Glassmail › Settings › Agents turn on "Allow AI agents to read my mail" and click Set Up next to Claude for Mac. Restart Claude. It now sees both accounts, and can be told to look at just one.

Can Claude send emails from my account through Glassmail?

No. Glassmail has no tool that sends or deletes mail. If you turn on changes, Claude can ask to archive, mark read, star, snooze or save a draft, and Glassmail asks you to allow each request.

Is it safe to let Claude read my email?

Claude can only read what Glassmail shares, and you can hide accounts, folders and senders. The mail Claude reads is sent to Anthropic to produce its answer, under Anthropic's privacy terms. If that isn't acceptable for some mail, hide it, or use Glassmail's built-in assistant, which runs on your Mac.

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