Skip to content

Apple Mail MCP v3.12.1

Choose a tag to compare

@agenticassets agenticassets released this 28 Aug 17:53
· 14 commits to main since this release
73a7532

Changes

  • Calendar reads now recover stable opaque references when calendarIdentifier is 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, adds mail_was_replied_to, nullable has_sent_reply and reply_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.