Errol Mail

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

FAQ from Errol Mail

What system requirements does Errol Mail need?

macOS 12.0+ (Monterey or later), Python 3.9+, and Apple Mail configured with at least one account.

How do I grant Full Disk Access for Errol Mail?

Run the provided diagnostic script check_fda.py, which identifies the exact binary path to add in System Settings > Privacy & Security > Full Disk Access.

Can Errol Mail modify emails without opening Mail windows?

Yes. All operations like marking read/unread and setting flags run completely headless via AppleScript, with no UI disruption. Changes automatically sync to IMAP/Exchange.

How does Errol Mail handle server-only emails?

It can check whether a message exists only on the server (metadata present but no