Errol Mail

Name: Errol Mail
Author: jasondk

@jasondk

Repository

About Errol Mail

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "errol": {
      "command": "python",
      "args": [
        "/absolute/path/to/errol-mail/server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.