imdinu/apple-mail-mcp

Overview

An MCP server for Apple Mail that provides full-coverage FTS5 body search over local mailboxes. It is designed to handle large mailboxes reliably, avoiding timeouts common with AppleScript-based alternatives.

Best for

Best for
Developers who need programmatic, searchable access to local Apple Mail data

Use cases

• Search email bodies with full-text queries
• Automate reading and retrieving messages from Apple Mail
• Integrate Apple Mail data into AI workflows or tools

How to use

Install

pipx install apple-mail-mcp

Tools exposed

• list_accounts()
• list_mailboxes(account?)
• get_emails(filter?, limit?)
• get_email(message_id)
• search(query, scope?, before?, after?, highlight?)
• get_email_links(message_id)
• get_email_attachment(message_id, filename)
• get_attachment(message_id, filename)

Tested with

Claude Code

Example client config

{\n  "mcpServers": {\n    "mail": {\n      "command": "apple-mail-mcp"\n    }\n  }\n}

Notes

An MCP server for Apple Mail that provides full-coverage FTS5 body search over local mailboxes. It is designed to handle large mailboxes reliably, avoiding timeouts common with AppleScript-based alternatives.

31 stars on GitHub. Last updated 2026-05-28. Licensed GPL-3.0.

Use cases

• Search email bodies with full-text queries
• Automate reading and retrieving messages from Apple Mail
• Integrate Apple Mail data into AI workflows or tools

Pros

• Performs fast, robust full-text search using FTS5
• Reliable on large mailboxes where AppleScript-based servers fail
• Open source and written in Python for easy customization

Cons

• Only works on macOS with Apple Mail installed
• Requires local Apple Mail access, no cloud integration
• Limited community support with only 31 GitHub stars

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.