Skip to content
MCP server

Apple Mail

Local MCP server for searching and reading Apple Mail with account-scoped access

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
1.40.0
Listing updated
3 days ago

About Apple Mail

Apple Mail is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

Mail is where the Cupertino servers lean hardest on speed. The README reports measurements from a 29,617-message mailbox and uses a read-only index for search and body reading, because asking Mail.app the same question over Apple Events can take over a minute. Apple Events remain for accounts, mailboxes and every change.

Three environment variables define the safety model. APPLE_MAIL_ACCOUNTS limits both reads and writes to named accounts, APPLE_MAIL_ALLOW_WRITES registers the mutating tools, and APPLE_MAIL_ALLOW_FILE_SEND separately allows a compose call to attach a local file and send in one step, since that skips human review.

It needs Automation permission for Mail. Full Disk Access unlocks search, message bodies and attachments; without it the server still lists accounts, mailboxes and counts. The README explains why that grant is better held by a dedicated menu-bar app than by an editor. It is unofficial and not affiliated with Apple.

Install

Run in a terminal

claude mcp add mcp-apple-mail -- npx -y @mgcrea/mcp-apple-mail

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-apple-mail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}

Configuration

  • APPLE_MAIL_ALLOW_WRITESRegister 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_ACCOUNTSRestrict every read and write to these Mail accounts, by name. Bounds reading, not just writing.
  • APPLE_MAIL_ALLOW_FILE_SENDLet the compose tools attach a local file and send in the same call. Attaching to a draft needs only writes; this is off by default because an immediate send puts the file in someone's inbox with nobody reviewing it.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

apple_mail_search_messages
Searches Mail messages
apple_mail_get_thread
Reads a mail thread

What it does

Threaded search
Finds messages and reads whole threads from mail already synced to the Mac.
Body search
Searches message bodies and reads attachments when Full Disk Access is granted.
Account scoping
APPLE_MAIL_ACCOUNTS bounds what can be read as well as written.
Gated sending
File attach-and-send needs its own opt-in flag, apart from general writes.
No mail credentials
Uses Mail already on the Mac, with no IMAP login or OAuth.

Good for

  • Find unread mail from one sender this quarter
  • Pull a full thread to draft a reply in your voice
  • Limit an agent to the work account only
  • Gather everything about a project from mail, notes and calendar

Pricing

Open source

MIT-licensed server; the Cupertino companion app lists a 30-minute trial and 30-day refund, prices not published

Prices change. Check cupertino.mgcrea.io before you buy.

Apple Mail FAQ

Does it need my IMAP password?

No. It reads mail already synced to your Mac.

What breaks without Full Disk Access?

Search, bodies and attachments are unavailable; accounts, mailboxes and counts still work.

Can it send email?

Only when writes are enabled, and attaching a file while sending needs APPLE_MAIL_ALLOW_FILE_SEND.

Is it official?

No, it is unofficial and not affiliated with Apple.

Is Apple Mail free?

Yes. Apple Mail is open source, so you can use and self-host it for free.

How do I add Apple Mail to Claude Code?

Run this command in your terminal: claude mcp add mcp-apple-mail -- npx -y @mgcrea/mcp-apple-mail

What are the best alternatives to Apple Mail?

The closest alternatives to Apple Mail are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

Alternatives to Apple Mail

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media