Apple Mail
Local MCP server for searching and reading Apple Mail with account-scoped access
- 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-mailAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-apple-mail": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-mail"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-apple-mail": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-mail"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media