Errol Mail MCP Server

What is Errol Mail?

Errol Mail is an MCP server that gives Claude comprehensive access to all of your email accounts in Apple Mail via SQL, local file access, and AppleScript-only when needed. It enables AI assistants to browse, read, search, and manage emails—including flags, attachments, and server-side message retrieval—entirely through natural language.

How to use Errol Mail?

Ensure you are on macOS 12+, have Python 3.9+, and Apple Mail configured with at least one account. Grant Full Disk Access using the included check_fda.py diagnostic script, which tells you the exact binary path to add. Clone the repository, install dependencies, then configure your MCP client (Claude Desktop or Claude Code) with the python /path/to/server.py command. Optionally install the included Claude skill for enhanced email workflows.

Key features of Errol Mail

• Browse all mailboxes and folders across accounts
• Search messages by subject, sender, or date range
• Read full email content and entire conversation threads
• Support for 7 flag colors and custom flag labels
• Headless message modifications (read/unread, flags) with no UI pop-up
• On-demand download of server-only emails to access your full archive

Use cases of Errol Mail

• Check unread or flagged emails that need immediate attention
• Read and summarize email threads about specific projects
• Automate email triage: flag urgent items red, mark newsletters as read
• Extract attachments from emails and save them to a temporary directory
• Search and download old archive emails not stored locally