Official description7 sourcesMCP servers8d ago

imdinu/apple-mail-mcp

Apple Mail access: list accounts and m

View on GitHub ↗Direct link · no redirect page

Config template (adjust for your client)

claude mcp add apple-mail-mcp -- npx -y apple-mail-mcp

A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.

Star count: 72 ★ · imdinu/apple-mail-mcp · read from the GitHub search API · (checked 2026-10-16 20:00:20)
Source: collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history: first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
Score: score 703 · 72 ★ · 7 sources · mcp

FAQ (answers come from our records)

How do I install it?

We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

repository imdinu/apple-mail-mcp；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.

Third-party quality signals

Apple Mail MCP

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

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 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
Add to your MCP client:
Build the Search Index (Recommended)
Configure (Optional)
Writes a commented config file you can edit to set defaults like your
primary account or mailbox. Every key has a matching APPLE_MAIL_* env
var if you prefer environment-based config. See
Configuration
for the full schema and precedence rules.
Tools
| Tool | Purpose |
|------|---------|
| list_accounts() | List email accounts |
| list_mailboxes(account?) | List mailboxes |
| get_emails(filter?, limit?) | Get emails — all, unread, flagged, today, last_7_days |
| get_email(message_id) | Get single email with full content + attachments |
| search(query, scope?, before?, after?, highlight?) | Search — all, subject, sender, body, attachments |
| get_email_links(message_id) | Extract links from an email |
| get_email_attachment(message_id, filename) | Extract attachment content |
| get_attachment(message_id, filename) | *Deprecated* — use get_email_attachment() |
Performance
Tested against 6 other Apple Mail MCP servers on a real **~73K-message** mailbox:
- **Only server with full-coverage body search.** Most competitors don't support body search at all; the one that does (BastianZim) live-scans only the 5000 most recent messages — silent miss on anything older. Our FTS5 index covers the entire mailbox.
- **~3ms single email fetch** via disk-first .emlx reading (no JXA round-trip).
- **~1ms list_accounts and ~5ms 50-email listing** via direct Envelope-Index SQLite reads (0.4+) — same path BastianZim/rusty/pl-lyfx use, with JXA as the correctness fallback.
- **~7ms subject search** via FTS5 — competitive with native Rust on the same operation.
- **Reliable across all 6 benchmarked operations** on a 73K mailbox; AppleScript-based servers timeout, throw syntax errors, or skip operations they don't support.