Repository navigation
Apple Mail MCP v3.12.1
Changes
- Calendar reads now recover stable opaque references when
calendarIdentifieris unavailable, carry those selectors through bounded reads and writes, and fail closed when an exact-name fallback is ambiguous. Calendar listings also expose source metadata when it is available. - Reply-state JSON now separates raw Mail metadata from verified Sent threading. It preserves
was_replied_to, addsmail_was_replied_to, nullablehas_sent_replyandreply_state, and reports the completeness and errors of the bounded Sent scan.
Install
| Client | Path |
|---|---|
| Claude Code | claude plugin marketplace add Agentic-Assets/apple-mail-mcp then claude plugin install apple-mail@apple-mail-mcp |
| Claude Desktop (chat) | Download apple-mail-mcp-v3.12.1.mcpb below, then Settings -> Extensions -> Install from file |
| Claude Desktop (Cowork) | Download apple-mail.plugin below, then Customize -> Add plugin -> Upload plugin |
| Codex | codex plugin marketplace add Agentic-Assets/apple-mail-mcp then codex plugin add apple-mail@apple-mail-mcp |
| Cursor | Point Cursor at the Agentic-Assets/apple-mail-mcp marketplace and install apple-mail |
macOS only. Requires Mail.app and Python 3.10+. The plugin launches with --draft-safe: it creates reviewable drafts and never sends mail on its own.