Apple Mail MCP Server

by mgcrea Your server? Claim it

local only

Apple Mail runs on your own machine — the client starts it, so there is no endpoint to ping. 1 241 installs a week from npm. Last commit 9 Sep 2026.

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

Installs per day peak 504 · avg 60 · +149% w/w

a month agotoday

1 241

Installs / week

npm · @mgcrea/mcp-apple-mail

Stars

2 open issues

9 Sep 2026

Last commit

0 releases in 90 days

MIT

License

TypeScript

Nothing serious here today

Today is the operative word: we check Apple Mail every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

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

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

~/.codex/config.toml

[mcp_servers.mcp-apple-mail]
command = "npx"
args = ["-y", "@mgcrea/mcp-apple-mail"]

.cursor/mcp.json

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

.vscode/mcp.json

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

Alternatives to Apple Mail

same job, measured the same way

Apple Notes

by mgcrea

Search, read and act on Apple Notes — folders, attachments, writes off by default

1 372 installs/wk local only

Apple Reminders

by mgcrea

Search, read and act on Apple Reminders — lists, due dates, writes off by default

1 222 installs/wk local only

Apple Maps

by mgcrea

Read and act on Apple Maps — favourites, Guides and recents, writes off by default

1 418 installs/wk local only

Apple Calendar

by mgcrea

Search, read and act on Apple Calendar — ranges, free-time lookup, writes off by default

1 383 installs/wk local only

Apple Contacts

by mgcrea

Search and read Apple Contacts — resolves numbers and emails to names, writes off by default

1 401 installs/wk local only

IMAP mailbox

by ni-c

Read, search and organise any IMAP mailbox, with writes off by default

265 installs/wk local only

Apple Safari

by mgcrea

Read and act on Safari — history, tabs and reading list, writes off by default

1 206 installs/wk local only

Apple Messages

by mgcrea

Search and read Apple Messages — chats and decoded text, sending off by default

1 423 installs/wk local only

Apple Mail — questions

Answers built from our own checks of this server.

Why is there no uptime for Apple Mail?

Apple Mail runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @mgcrea/mcp-apple-mail was installed 1 241 times last week.

How do I connect Apple Mail?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls @mgcrea/mcp-apple-mail straight from npm; nothing to host, nothing to sign up for.

How many people use Apple Mail?

The npm package @mgcrea/mcp-apple-mail was installed 1 241 times in the last week. Week over week that is +149%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Apple Mail open source?

Yes — it is published under the MIT licence, written in TypeScript, 2 stars on GitHub and 2 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.