Apple Mail MCP
by imdinucommunityv0.1.2
15
7
Apple Mail MCP is a server that enables full-text email search and reliable access to large mailboxes without timing out. It provides various tools for reading, searching, and extracting email content.
From the registry: Fast MCP server for Apple Mail with batch JXA and FTS5 search index.
Install & configure
Prerequisites
- requiredInstall apple-mail-mcpInstall via pipx (preferred)
$ pipx install apple-mail-mcp - requiredFull Disk AccessGrant Full Disk Access to your terminal or MCP host: System Settings -> Privacy & Security -> Full Disk Access
- optionalBuild search indexRecommended: build the FTS5 index before first use
$ apple-mail-mcp index --verbose
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `apple-mail-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install apple-mail-mcp** — Install via pipx (preferred) Run: `pipx install apple-mail-mcp`
- **Full Disk Access** — Grant Full Disk Access to your terminal or MCP host: System Settings -> Privacy & Security -> Full Disk Access
Optional prerequisites:
- Build search index — Recommended: build the FTS5 index before first use Run: `apple-mail-mcp index --verbose`
Canonical MCP server config (stdio transport):
- command: `apple-mail-mcp`
- args: []
- optional environment variables:
- `APPLE_MAIL_DEFAULT_ACCOUNT`: Default email account (example: `Work`)
- `APPLE_MAIL_DEFAULT_MAILBOX`: Default mailbox (example: `INBOX`)
- `APPLE_MAIL_INDEX_PATH`: Index DB path (example: `~/.apple-mail-mcp/index.db`)
- `APPLE_MAIL_INDEX_MAX_EMAILS`: Max emails indexed per mailbox (example: `5000`)
- `APPLE_MAIL_INDEX_EXCLUDE_MAILBOXES`: Mailboxes to skip in search (example: `Drafts`)
- `APPLE_MAIL_READ_ONLY`: Disable write operations (example: `false`)
Note: macOS only. Optional --watch flag for live indexing. Python 3.11+.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: macOS only. Optional --watch flag for live indexing. Python 3.11+.
Tools (7)
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
Environment variables
APPLE_MAIL_DEFAULT_ACCOUNTrequiredDefault email accountAPPLE_MAIL_DEFAULT_MAILBOXrequiredDefault mailboxAPPLE_MAIL_INDEX_PATHrequiredIndex locationAPPLE_MAIL_INDEX_MAX_EMAILSrequiredMax emails indexed per mailboxAPPLE_MAIL_INDEX_EXCLUDE_MAILBOXESrequiredMailboxes to skip in searchAPPLE_MAIL_READ_ONLYrequiredDisable write operationsPrerequisites
- • Python 3.11+
Packages
apple-mail-mcp
pypiv0.1.2transport: stdio
Details
- Language
- Python
- License
- GPL-3.0
- Released
- Feb 19, 2026
- Last commit
- Apr 5, 2026
- Registry name
- io.github.imdinu/apple-mail-mcp