Apple Mail Mcp
by jayvee6communityv0.1.0
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: LLM access to Apple Mail and iCloud via AppleScript. Read, search, compose, reply, flag and delete.
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
@jdot6/apple-mail-mcp
npmv0.1.0transport: stdio
Details
- Language
- TypeScript
- Released
- May 3, 2026
- Last commit
- May 4, 2026
- Registry name
- io.github.jayvee6/apple-mail-mcp