MCP.so
Sign In
E

Errol Mail

@jasondk

Repository

About Errol Mail

No overview available yet

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.

How does Errol Mail handle server-only emails?

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

Frequently asked questions

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

Comments

Basic information

Category

Other

Transports

stdio

Author

jasondk

Submitted by

Jason de Koning

More Other MCP servers

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K