iCloud MCP

icloud-mcp covers seven Apple services with two interchangeable backends, and as far as we know it is the only MCP server that does. In local mode it drives the native macOS apps through AppleScript: no credentials, no network, and it reaches the services the iCloud protocols do not expose (Reminders, Notes, Messages, Safari). In cloud mode it speaks IMAP/SMTP, CalDAV and CardDAV instead, so it runs on any machine…. Its 38 documented tools cover contact, reminder, safari, event.

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

VERIFIED ACTIVE

LAST COMMIT 2026-08-11 · ★ 36 · #18 OF 75 MAINTAINED EMAIL · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install iCloud MCP

before you install - you'll need

Set USE_LOCAL_MODE, ICLOUD_EMAIL, ICLOUD_APP_PASSWORD, ICLOUD_MCP_IMSG_PATH before connecting.

Claude Code

claude mcp add mrgo2-icloud-mcp -- npx -y mcp-icloud

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mrgo2-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ]
    }
  }
}

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 mcp-icloud - unscoped; check the name against the project README before installing

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

03 · What iCloud MCP 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 query, from, subject, folder (strings, optional), unreadOnly (boolean, optional), count (number, optional), count (number, optional, max 50), daysAhead (number, optional), count (number, optional, max 50), and query (string), count (number, optional). Matches name, organisation, email and phone.

Capability map

Tools grouped from the project's README - what iCloud MCP lets an agent do.

read & search

7 tools - e.g. no input; count (number, optional, max 50), daysAhead (number, optional); no input

list-folders · list-events · list-calendars · list-chats · read-messages · list-safari-tabs…

Contact

5 tools - e.g. contactUrl (string); displayName, firstName, lastName, email, phone, organization, title, notes (all optional); contactUrl (string)

read-contact · create-contact · delete-contact · list-contact-accounts · list-contact-groups

Reminder

5 tools - e.g. no input; name (string); body, dueDate, listName (optional); priority (number 0-9, optional); reminderId (string); any of name, body, dueDate, priority

list-reminder-lists · create-reminder · update-reminder · complete-reminder · delete-reminder

Event

3 tools - e.g. summary, start, end (strings, ISO 8601); description, location (optional); calendarUrl (cloud) or calendarName (local); eventUrl (string); any of summary, start, end, description, location. Only the…

create-event · update-event · delete-event

Note

3 tools - e.g. no input; noteId (string); title (string), body (string, optional), folderName (string, optional)

list-note-folders · read-note · create-note

Emails

2 tools - e.g. folder (string, optional), count (number, optional, max 50); query, from, subject, folder (strings, optional), unreadOnly (boolean, optional), count (number, optional)

list-emails · search-emails

2 tools - e.g. uid (string), folder (string, optional); to, subject, body (strings); cc, bcc (strings, optional); isHtml (boolean, optional, cloud mode only)

read-email · send-email

Contacts

2 tools - e.g. count (number, optional, max 50); query (string), count (number, optional). Matches name, organisation, email and phone; phone matching ignores formatting

list-contacts · search-contacts

Limitations (from the README)

- list-note-folders: no input - list-notes: folderName (string, optional), count (number, optional) - read-note: noteId (string) - create-note: title (string), body (string, optional), folderName (string, optional) - search-notes: query (string), count (number, optional)

Latest releases

v2.1.3 · 2026-08-11

v2.1.2 · 2026-08-11

v2.1.1 · 2026-08-09

First version installable with a one-liner: npx -y mcp-icloud - the package cleared npm's publish-time review with the new dual-use disclosure included. · Changes since v2.1.0 · DISCLOSURE + contentPolicy metadata in…

04 · Who maintains iCloud MCP

iCloud MCP is maintained by mrgo2. We track 2 MCP servers from mrgo2 - 2 actively maintained, 37 combined GitHub stars, oldest repo from Jan 2026.

05 · Facts

repository: github.com/mrgo2/icloud-mcp
website: https://github.com/MrGo2/icloud-mcp#readme
category: email - ranked #18 of 75 actively-maintained email servers as of 2026-08-25.
release cadence: 4 releases in the last 90 days (latest 2026-08-11)
registry: io.github.MrGo2/icloud-mcp (active, first published 2026-08-09 · 3 versions)
packages: npm:mcp-icloud

06 · iCloud MCP FAQ

Is iCloud MCP still maintained?

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

What can iCloud MCP do?

How do I install iCloud MCP?

Run `npx -y mcp-icloud`. The README documents 4 environment variables (USE_LOCAL_MODE, ICLOUD_EMAIL, ICLOUD_APP_PASSWORD…) to set first. Set USE_LOCAL_MODE, ICLOUD_EMAIL, ICLOUD_APP_PASSWORD, ICLOUD_MCP_IMSG_PATH before connecting. You can also paste the ready-made client config above.

Does iCloud MCP 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 iCloud MCP

Alternatives to iCloud MCP

Maintained email servers if iCloud MCP isn't the fit.

More email MCP servers · Multimail Dev MCP Server · Better Email MCP · Clippy · Maket · Imap MCP Server

More JavaScript MCP servers · Rippr MCP · Xendit MCP · Gitstandup · Reddit MCP Server (mypracticaltools) · see all