Apple Mail MCP

An MCP server for Apple Mail on macOS: search, reading, drafts, rules and attachments, with confirmation for dangerous steps.

  • 105 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Reads and changes your mail, can send messages and create forwarding rules
  • Mail and attachment contents go into the model context
All reasons and checks

s-morgan-jeffries/apple-mail-fast-mcp

Install

Manual install

/plugin marketplace add s-morgan-jeffries/apple-mail-fast-mcp
/plugin install apple-mail-fast@apple-mail-fast-mcp

Plugin install for Claude Code from the README. For Claude Desktop there is an `.mcpb` bundle on the releases page.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Reads and changes your mail, can send messages and create forwarding rules
  • Mail and attachment contents go into the model context

This is third-party code. Review the repository files before installing.

What it does

The server gives an agent access to Apple Mail on macOS through 25 tools, of which 11 only read and 14 change data. Reading: lists of mailboxes and accounts, message search and retrieval, threads, statistics, attachment content, templates. Actions: flags, moving and deleting to Trash, saving attachments to disk with a size cap, reply or forward drafts, creating and editing mailboxes, rules and templates. Destructive operations (`delete_*`, `create_rule` with move, forward or delete actions, `create_draft` with `send_now=true`) ask for confirmation through MCP elicitation. Installation: an `.mcpb` file for Claude Desktop or a Claude Code plugin via `/plugin marketplace add`. `uv` resolves dependencies.

Who it is for. macOS users with Apple Mail configured who want to triage mail, draft replies and tidy mailboxes through Claude.

Good fit when

  • Triage the inbox by topic and show a per-mailbox summary.
  • Prepare a reply or forward draft from an email thread.
  • Save attachments from selected messages to a folder on disk.
  • Create a sorting rule or a template for standard replies.

Not a fit when

  • You are not on macOS or do not use Apple Mail: the server works only with that client.
  • The agent must not see mail content and attachments.
  • A stable version is needed: the project is pre-1.0 and the tool surface changes.

Example request

Find emails from accounting over the last month, make a short summary and prepare a draft reply to the latest one without sending.

MCP

Transport
stdio
Authentication
not required

Limitations

It works only on macOS 10.15 or newer with Apple Mail configured and Python 3.10+, controlling mail through AppleScript. The project is pre-1.0: tool names, parameters and response shapes still change, so pin a version such as `apple-mail-fast-mcp==0.11.0` and read the changelog. Mail and attachment contents enter the model context and forwarding rules can send mail out, so never confirm them unread. The repository was last updated on 9 September 2026 and uses the MIT licence.

How to disable. Remove the server in Claude Desktop settings (Extensions) or run `/plugin uninstall` for the Claude Code plugin. Delete rules and templates created in Mail by hand in the app itself.

FAQ

How many tools does the server have?

Twenty-five: eleven read only and fourteen change data. Full parameters are in `docs/reference/TOOLS.md`.

Which actions require confirmation?

Deletion, rules that move, forward or delete messages, and sending a draft with `send_now=true`.

How to install in Claude Desktop?

Download the `.mcpb` file from the releases page and open it or drag it into Settings, then Extensions; `uv` pulls Python and dependencies.

Does it work on Windows or Linux?

No, macOS 10.15+ and the Apple Mail app with at least one configured account are required.

Can the version be pinned?

Yes, and the README advises doing so before 1.0, for example `apple-mail-fast-mcp==0.11.0`, because the tool surface changes.

Discussion

No questions or reviews yet.

An MCP server for Mail on Mac: an agent reads, searches, writes and sorts email and triages the inbox, with a read-only mode

MCP serverBroad access256Repository stars

An MCP server for Apple Mail on macOS: 8 read tools and body search through an FTS5 index on large mailboxes

MCP serverBroad access74Repository stars

MCP server for Apple Mail on macOS: read, search, send and organize mail through AppleScript or IMAP and SMTP.

MCP serverBroad access111Repository stars

An MCP server for macOS: an agent reads, searches and sends messages in the Messages app on your Mac

MCP serverBroad access344Repository stars

An email MCP with 52 tools: the agent reads, searches, sends and sorts mail across several accounts over IMAP and SMTP, and schedules sends

MCP serverBroad access158Repository stars
Official

A local MCP server for Mac and Windows that lets an agent work with mail, messengers, calendars and files.

MCP serverBroad access81Repository stars

README in short

The README groups tools by lifecycle, warns about the pre-1.0 version and gives two install paths: an `.mcpb` bundle and a plugin.

README badge

Report a problem