MCP.Market

Apple Mail MCP server

by imdinu·io.github.imdinu/apple-mail-mcp·v0.5.0·68 stars
No reviews yet

Apple Mail MCP server with full-coverage FTS5 body search, reliable on large mailboxes.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Established

68 stars330 downloads/wk

Reviews

Write one

Nobody has reviewed Apple Mail MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Apple Mail MCP tools (8, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_attachment

    DEPRECATED: Use get_email_attachment() or get_email_links().

  • get_emailwrite action

    Get a single email with full content.

  • get_email_attachmentwrite action

    Extract a file attachment from an email and save to disk.

  • get_email_linkswrite action

    Extract hyperlinks from an email's HTML content.

  • get_emails

    Get emails from a specific mailbox with optional filtering.

  • list_accounts

    List all configured email accounts in Apple Mail.

  • list_mailboxes

    List all mailboxes for an email account.

  • search

Public scan report

scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it

no findings
  • Code scan19 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 19 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Apple Mail MCP compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 90% of 3,470 Web search servers
Tools
8
the typical Web search server has 5
Tools that change things
38%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
68
more than 93% of 1,786 Web search servers
Downloads a week
330
more than 79% of 827 Web search servers with a package

What its tools let an agent do: 5 read · 3 change

Install Apple Mail MCP in Claude Code, Cursor or VS Code

claude mcp add apple-mail-mcp -- uvx apple-mail-mcp
Add to Cursor

What the publisher says

From the Apple Mail MCP repository's README, as published. We do not edit it. Read it on GitHub

Apple Mail MCP

<!-- mcp-name: io.github.imdinu/apple-mail-mcp -->

The only Apple Mail MCP server with full-coverage body search — reliable on large mailboxes where AppleScript-based servers timeout. 8 tools for reading, searching, and extracting email content.

Read the docs for the full guide.

Quick Start

Claude Code (plugin)

claude plugin marketplace add imdinu/apple-mail-mcp
claude plugin install apple-mail@imdinu

Claude Desktop (one-click bundle)

Download apple-mail-mcp-.mcpb from the latest release and double-click it.

Both the plugin and the bundle run the released PyPI package via a thin launcher (uvx → pipx → private venv, whichever is available) — no vendored code, identical behavior to a manual install. They start the server with --watch; grant Full Disk Access to the launching app (Claude Code / Claude Desktop) so the index stays fresh.

Any MCP client

pipx install apple-mail-mcp

Add to your MCP client:

{
  "mcpServers": {
    "mail": {
      "command": "apple-mail-mcp"
    }
  }
}

Build the Search Index (Recommended)

# Requires Full Disk Access for Terminal
# System Settings → Privacy & Security → Full Disk Access → Add Terminal

apple-mail-mcp index --verbose

Configure (Optional)

apple-mail-mcp init   # writes ~/.apple-mail-mcp/config.toml

Writes a commented config file you can edit to set defaults like your primary account or mailbox. Every key has a matching APPLEMAIL env var if you prefer environment-based config. See Configuration for the full schema and precedence rules.

Tools

Performance

Tested against 6 other Apple Mail MCP servers on a real ~73K-message mailbox:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Apple Mail MCP: common questions

Is Apple Mail MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the Apple Mail MCP safety report
How do I install Apple Mail MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Apple Mail MCP need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Apple Mail MCP maintained?
The last commit was 51 days ago (2026-09-14). The latest release is v0.5.0.
What can I use instead of Apple Mail MCP?
Servers from other publishers that do the same job: HIG Doctor MCP server, Apple Notes MCP server and OfficeIMO Document Tools MCP server.
How does Apple Mail MCP compare with other Web search MCP servers?
safety score 92/100 (higher than 90% of 3,470 Web search servers); tools 8 (the typical Web search server has 5); tools that change things 38% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Apple Mail MCP

Same job from other publishers: the closest match first, then the best rated.

  • HIG Doctor
    Apple Human Interface Guidelines search, lookup, and project audits for AI coding agents.
    B
  • Apple Notes
    Inspect, search, create, edit, move, and organize notes in Apple Notes on macOS.
    More from JonathanRReed →
    A
  • OfficeIMO Document Tools
    Inspect, search, fetch, and convert local documents and mail stores with bounded access.
    A
  • Gdelt
    Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs.
    A