Apple Mail MCP Server

io.github.mgcrea/mcp-apple-mail

Repository Registry

What is the Apple Mail MCP server?

Search, read and act on Apple Mail — threads, attachments, body search, writes off by default

How to install Apple Mail

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

APPLE_MAIL_ALLOW_WRITES
Register the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.
APPLE_MAIL_ACCOUNTS
Restrict every read and write to these Mail accounts, by name. Bounds reading, not just writing.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ],
      "env": {
        "APPLE_MAIL_ALLOW_WRITES": "<YOUR_APPLE_MAIL_ALLOW_WRITES>",
        "APPLE_MAIL_ACCOUNTS": "<YOUR_APPLE_MAIL_ACCOUNTS>"
      }
    }
  }
}