rusty_apple_mail_mcp

Read-only MCP server for Apple Mail on macOS.

It gives an LLM or AI agent fast local access to Apple Mail metadata, message bodies, and attachment text without AppleScript and without IMAP/POP/EWS network calls.

Apple Mail already contains the data an agent needs, but it is buried in a local SQLite index and scattered .emlx files.

This project exposes that storage through a small, intent-driven MCP interface so an agent can:

• locate messages by subject, date range, sender, participant, mailbox, or account;
• fetch a full message including metadata, recipients, body, and attachment summary;
• extract readable text from supported attachments;
• operate completely locally and read-only.

In practice, it empowers AI workflows to search and read your mail archive safely and quickly, without relying on Mail.app automation like AppleScript (which damn slow and throws timeouts regularly) or network protocols.

The current tool set is intentionally compact:

| Tool | What it does | |---|---| | search_messages | Search by subject, dates, sender, participant, account, or mailbox | | list_accounts | Discover account identifiers; set include_mailboxes=true for combined account+mailbox discovery | | get_message | Read one message in full; recipients omitted by default (include_recipients=true to include) | | get_attachment_content | Extract readable attachment content | | list_mailboxes | List mailboxes/folders with message counts