Fast MCP server for Apple Mail with full-coverage body search and tools for listing, filtering, and extracting emails and attachments.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for imdinu/apple-mail-mcp, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Overview
Use cases
List email accounts and mailboxes
Fetch emails with filters like unread or recent
Perform full-text search on email subjects, senders, bodies, and attachments
Retrieve full email content including attachments
Extract links or specific attachments from emails
Key features
Full-coverage FTS5 body search index for fast queries
Batch JXA and direct SQLite reading for high performance
Tools for listing accounts, mailboxes, and emails with filters
Support for extracting email links and attachments
Configurable via CLI, config file, or environment variables
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Apple Mail MCP.
Extracted Tool Capabilities
Full-coverage FTS5 body search index for fast queries
Batch JXA and direct SQLite reading for high performance
Tools for listing accounts, mailboxes, and emails with filters
Support for extracting email links and attachments
Configurable via CLI, config file, or environment variables
Documentation Overview
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
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
.emlxreading (no JXA round-trip). - ~1ms
list_accountsand ~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.
Configuration
Apple Mail MCP works out of the box. To customize defaults, run
apple-mail-mcp init to generate a config.toml template — or use
the matching APPLE_MAIL_* environment variables. See the
Configuration docs
for the full schema and the CLI > env > file > default precedence.
Per-client env overrides via the MCP client's launch config also work:
CLI Usage
All tools are also available as standalone CLI commands (no MCP server needed):
All commands output JSON. Generate a Claude Code skill for CLI-based access:
Development
License
GPL-3.0-or-later
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
63
Stargazers on the source repository.
Last commit
18d ago
Most recent push to the default branch.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Apple Mail MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/imdinu-apple-mail-mcp)HTML Embed
<a href="https://allmcps.com/mcp/imdinu-apple-mail-mcp"><img src="https://allmcps.com/api/badge/imdinu-apple-mail-mcp?style=directory" alt="Apple Mail MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryCommunication
13/13 checks healthy over the last 32d
47Quality signal: Fair · 47/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools18/30
Adoption & activity7/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.