Apple Mail MCP (jayvee6)

The only way to give Claude (or any LLM) access to Apple Mail and iCloud. Gmail and Outlook have APIs. iCloud doesn't. If you're a Mac user whose email lives in Apple Mail - iCloud, iCloud+, or any account synced through it - there's no web API an LLM can call. This server bridges that gap using AppleScript on your local machine. Its 22 documented tools cover email, emails, reply, rule.

People connecting email tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-16 · ★ 2 · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Apple Mail MCP (jayvee6)

before you install - you'll need

Set APPLE_MAIL_AI_PROVIDER, APPLE_MAIL_AI_ENDPOINT, APPLE_MAIL_AI_MODEL before connecting.

Claude Code

claude mcp add jayvee6-apple-mail-mcp -- npx -y @jdot6/apple-mail-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "jayvee6-apple-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jdot6/apple-mail-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @jdot6/apple-mail-mcp - the @jdot6 scope differs from the repo owner (jayvee6); confirm it's the project's official package

registry namespace io.github.jayvee6 is GitHub-verified and matches the repo owner

03 · What Apple Mail MCP (jayvee6) can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all accounts and their mailboxes, create a new mailbox/folder in an account (idempotent), read a message's full headers and body, and filter by sender, subject, date range across mailboxes.

Capability map

Tools grouped from the project's README - what Apple Mail MCP (jayvee6) lets an agent do.

9 tools - e.g. Read a message's full headers and body; Create a draft or send a new message immediately; Reply to a message, open as draft or send immediately

get_email · compose_email · reply_email · move_email · archive_email · flag_email…

read & search

3 tools - e.g. List all accounts and their mailboxes; List all Mail rules with their move-target folder and matched sender domains; Drain real-time new-mail events from the MailKit bridge

list_folders · list_rules · get_pending_events

Emails

2 tools - e.g. Paginate messages in a mailbox (newest-first); Filter by sender, subject, date range across mailboxes

list_emails · search_emails

update

2 tools - e.g. Bulk-move all messages matching a filter into a mailbox; Move to Junk (iCloud) or Spam (Gmail)

move_matching · move_to_junk

Rule

2 tools - e.g. Create a native Mail rule filing sender domains into a folder (optionally sort existing mail too); Delete a Mail rule by name

create_rule · delete_rule

create & write

1 tool - e.g. Create a new mailbox/folder in an account (idempotent)

create_folder

Mark

1 tool - e.g. Mark a message as read or unread

mark_read

Draft

1 tool - e.g. Draft a reply body via local AI (review before sending)

draft_reply

Latest releases

v1.1.0 · 2026-07-07

What's new · Rule-based filing tools (thanks @EBoiSha - first external contribution! #2) · create_folder - create a mailbox/folder in any account (idempotent) · move_matching - bulk-move all messages matching a…

v1.0.0 · 2026-06-16

What's in 1.0.0 · 17 MCP tools covering the full Apple Mail lifecycle - the only way to give Claude access to iCloud and Apple Mail. · Core tools · | Tool | What it does | · |------|-------------| · | list_folders |…

v1.0 · 2026-05-04

What's included · apple-mail-mcp - MCP server giving Claude full access to Apple Mail via AppleScript (read, search, compose, reply, move, flag, delete) · MailKit Bridge - notarized macOS app extension that pushes…

04 · Who maintains Apple Mail MCP (jayvee6)

Apple Mail MCP is maintained by jayvee6. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/jayvee6/apple-mail-mcp
category: email - actively maintained as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-07-07)
registry: io.github.jayvee6/apple-mail-mcp (active, first published 2026-05-03)
packages: npm:@jdot6/apple-mail-mcp

06 · Apple Mail MCP (jayvee6) FAQ

Is Apple Mail MCP (jayvee6) still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-16 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Apple Mail MCP (jayvee6) do?

How do I install Apple Mail MCP (jayvee6)?

Run `npx -y @jdot6/apple-mail-mcp`. The README documents 3 environment variables (APPLE_MAIL_AI_PROVIDER, APPLE_MAIL_AI_ENDPOINT, APPLE_MAIL_AI_MODEL) to set first. Set APPLE_MAIL_AI_PROVIDER, APPLE_MAIL_AI_ENDPOINT, APPLE_MAIL_AI_MODEL before connecting. You can also paste the ready-made client config above.

Does Apple Mail MCP (jayvee6) run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Apple Mail MCP (jayvee6)

Alternatives to Apple Mail MCP (jayvee6)

Maintained email servers if Apple Mail MCP (jayvee6) isn't the fit.

More email MCP servers · Mailbox MCP · Apple Mail · Che Apple Mail MCP · Mail Fathom · Outlook Assistant

More TypeScript MCP servers · Packet Tracer MCP · Flaim Fantasy · Revolut MCP · Codeseeker · see all