The JXA Mail MCP server provides fast programmatic access to Apple Mail on macOS through 7 tools, enabling email management, search, and automation via the Model Context Protocol.
Core Capabilities:
Account & Mailbox Management - List all configured email accounts and their mailboxes with unread counts
Email Retrieval - Fetch emails with standard properties (ID, subject, sender, date, read/flagged status) with filters for all emails, today's emails, unread emails, or flagged emails from specific accounts/mailboxes
Search & Discovery - Search emails by query string across subject and sender fields (case-insensitive), with optional FTS5 full-text search index for body content searches
Performance Optimizations:
87x faster email retrieval using JXA batch property fetching vs. traditional per-message iteration
700-3500x faster body search (~2ms vs ~7s) with optional SQLite FTS5 search index
Real-time index updates via
--watchflag for automatic synchronization when new emails arriveFast startup times (<5s) using disk-first sync approach
Configuration & Security:
Customizable via environment variables for default accounts, mailboxes, index location, and email limits
Built-in protections against SQL injection, JXA injection, XSS, DoS attacks, and path traversal
Works with Claude Desktop and other MCP-compatible tools through natural conversation
Enables programmatic interaction with Apple Mail on macOS, allowing for listing accounts and mailboxes, fetching recent, unread, or flagged emails, and searching for messages by sender or subject.
Allows for managing and retrieving email content from iCloud accounts configured within the Apple Mail application.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apple Mail MCPShow me my unread emails from today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apple Mail MCP
A fast MCP server for Apple Mail — disk-first email reading, 87x faster batch fetching via JXA, and an FTS5 search index for 700–3500x faster body search (~2ms vs ~7s).
Read the docs for the full guide.
Quick Start
pipx install apple-mail-mcpAdd 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 --verboseTools
Tool | Purpose |
| List email accounts |
| List mailboxes |
| Get emails — all, unread, flagged, today, this_week |
| Get single email with full content + attachments |
| Search — all, subject, sender, body, attachments |
| Extract attachment content (base64) |
Performance
Scenario | Apple Mail MCP | Best alternative | Speedup |
Fetch single email | 6ms | unsupported | Only one (disk-first) |
Fetch 50 emails | 301ms | 13,800ms+ | 46x faster |
Search (subject) | 10ms | 148ms | 15x faster |
Search (body) | 22ms | unsupported | Only one |
List accounts | 118ms | 134ms | Fastest |
Benchmarked against 5 other Apple Mail MCP servers at the MCP protocol level.
Configuration
Variable | Default | Description |
| First account | Default email account |
|
| Default mailbox |
|
| Index location |
|
| Max emails indexed per mailbox |
|
| Mailboxes to skip in search |
{
"mcpServers": {
"mail": {
"command": "apple-mail-mcp",
"args": ["--watch"],
"env": {
"APPLE_MAIL_DEFAULT_ACCOUNT": "Work"
}
}
}
}Migrating from apple-mcp?
If you used supermemoryai/apple-mcp (archived January 2026), apple-mail-mcp is a maintained alternative for the Mail portion specifically. Notes, Messages, Contacts, Calendar, and Reminders are out of scope.
apple-mcp ( | apple-mail-mcp |
|
|
|
|
| Not yet supported (planned) |
What's different: available on PyPI (pipx install apple-mail-mcp), disk-first single-email reads (~1-5ms via .emlx parsing), 87x faster batch fetching via JXA, FTS5 search index for ~2ms body search, and disk-based sync that avoids JXA timeouts and false-success responses.
Development
git clone https://github.com/imdinu/apple-mail-mcp
cd apple-mail-mcp
uv sync
uv run ruff check src/
uv run pytestLicense
GPL-3.0-or-later