Help · AI features

AI apps (MCP)

Updated

Let Claude, Cursor and other AI apps on your Mac find and tidy your mail. Changes wait for your OK.

Claude, Cursor and other AI apps on your Mac can use Mailroom with the same tools as the Assistant, through MCP (the Model Context Protocol). Ask Claude to "archive the newsletters in my Inbox", or "what did Maya say about the invoice?", and it searches and reads your mail in Mailroom.

Changes wait for you. When an app asks to change mail, Mailroom shows a card with its own count of the mail and what will happen, and nothing changes until you approve it in Mailroom. You can turn that off, and let apps change mail as soon as they ask.

In Mailroom’s AI apps view, Claude searched the Inbox for Northwind Bank statements, read June’s, and asks "Archive 12 conversations?", with Archive, Cancel and Show in list

Turn it on

In Settings › AI › AI apps, check Let AI apps on this Mac use Mailroom. Mailroom makes a key for your apps, kept encrypted with your Keychain, and answers them at http://127.0.0.1:6245/mcp, on your Mac only.

Settings › AI › AI apps, on: the address, used by Claude just now, Ask me in Mailroom before an app changes mail, the key, Add to Claude Desktop, and setup for Claude Code and other apps

Then connect your app:

AppHow
Claude DesktopClick Add to Claude Desktop…, and Claude asks to install Mailroom’s extension, then for the key. Mailroom has copied it: paste it.
Claude CodeClick Copy Command, paste it in Terminal and press Return.
Cursor, Windsurf, LM StudioClick Copy for Cursor, and paste it into the app’s mcp.json.
VS CodeClick Copy for VS Code, and paste it into mcp.json.
Other appsAny app that connects to MCP servers over HTTP: use Copy Address, and send the key as a bearer token, Authorization: Bearer <key>.

What an app can do

It can search your mail, with the same words and operators as the search box, and read the conversations it finds. It can ask to move mail to Trash, archive it, move it to a folder, tag it, mark it read or unread, star it, snooze it, or unsubscribe from a list. It can’t delete mail for good, empty Trash, or write or send email, and it can’t change Mailroom’s settings.

Approving a change

When an app asks for a change, Mailroom opens the Assistant panel on AI apps with a card, like Archive 12 conversations?, showing the search it used and the newest few. If Mailroom isn’t in front, a notification says so. Click the button to do it, with Undo for a few seconds after, or Cancel. Show in list puts the same search in the search box, to look through all of it first.

The app hears what you decided. If you take longer than about 45 seconds, it’s told the card is still waiting in Mailroom, and it can ask again later. A card nobody answers is withdrawn after an hour.

The AI apps view also lists what each app searched and read, under its name. The clear button takes away what’s done.

Without asking. Uncheck Ask me in Mailroom before an app changes mail, and apps change mail as soon as they ask. The app’s own permission prompt is then your only check, so leave it on if you’ve told an app to always allow Mailroom’s tools. Each change still shows in the AI apps view, with Undo for a few seconds if Mailroom is in front.

Privacy

Good to know

Still stuck? email support@getmailroom.dev. A person reads every message.

Ask a question