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
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
Install
- Works in
Manual install
/plugin marketplace add s-morgan-jeffries/apple-mail-fast-mcp
/plugin install apple-mail-fast@apple-mail-fast-mcpPlugin install for Claude Code from the README. For Claude Desktop there is an `.mcpb` bundle on the releases page.
Access and checks
How we reviewBroad 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.
Related
MCP serversAn MCP server for Mail on Mac: an agent reads, searches, writes and sorts email and triages the inbox, with a read-only mode
An MCP server for Apple Mail on macOS: 8 read tools and body search through an FTS5 index on large mailboxes
MCP server for Apple Mail on macOS: read, search, send and organize mail through AppleScript or IMAP and SMTP.
An MCP server for macOS: an agent reads, searches and sends messages in the Messages app on your Mac
An email MCP with 52 tools: the agent reads, searches, sends and sorts mail across several accounts over IMAP and SMTP, and schedules sends
A local MCP server for Mac and Windows that lets an agent work with mail, messengers, calendars and files.
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.