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
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 --verboseConfigure (Optional)
apple-mail-mcp init # writes ~/.apple-mail-mcp/config.tomlWrites 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() |
