Keyflow
Contact

Search Keyflow

Find a shortcut, workflow, MCP server or skill

iCloud MCP

local MCP server

iCloud MCP is a local MCP server: Apple Mail, Calendar, Contacts, Reminders, Notes, Messages and Safari via AppleScript or iCloud. Install it from npm as mcp-icloud.

Installation

Terminal

claude mcp add io-github-mrgo2-icloud-mcp -e USE_LOCAL_MODE=... -e ICLOUD_EMAIL=... -e ICLOUD_APP_PASSWORD=... -- npx -y mcp-icloud

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "io-github-mrgo2-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "USE_LOCAL_MODE": "...",
        "ICLOUD_EMAIL": "...",
        "ICLOUD_APP_PASSWORD": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

What you need

  • Runtime: Node.js 18+ (runs with npx).
  • MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
  • Environment variables: USE_LOCAL_MODE, ICLOUD_EMAIL, ICLOUD_APP_PASSWORD

Summary

Apple Mail, Calendar, Contacts, Reminders, Notes, Messages and Safari via AppleScript or iCloud

iCloud MCP vs similar servers

ServerStarsTypeAPI keyRuntime
iCloud MCP54LocalYesnpm
Apple Tools (Unified)18LocalYespypi
AIquila — Nextcloud MCP Server38HostedYesNone
apple-reminders10LocalNonpm
DocsAgent — Zotero, Obsidian & Apple Notes MCP Server623LocalYesnpm

Questions

It reads 3 environment variables: USE_LOCAL_MODE, ICLOUD_EMAIL, ICLOUD_APP_PASSWORD. Set them in your MCP config before starting the server.

Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.

iCloud MCP is a local MCP server distributed as the npm package mcp-icloud.

Run: claude mcp add io-github-mrgo2-icloud-mcp -e USE_LOCAL_MODE=... -e ICLOUD_EMAIL=... -e ICLOUD_APP_PASSWORD=... -- npx -y mcp-icloud

Run: codex mcp add io-github-mrgo2-icloud-mcp --env USE_LOCAL_MODE=... --env ICLOUD_EMAIL=... --env ICLOUD_APP_PASSWORD=... -- npx -y mcp-icloud

Similar MCP servers

NameStars
  1. Apple Tools (Unified)io.github.JonathanRReed/apple-tools-mcp18
  2. AIquila — Nextcloud MCP Serverio.github.elgorro/aiquila-mcp38
  3. apple-remindersio.github.high5-ventures/apple-reminders10
  4. DocsAgent — Zotero, Obsidian & Apple Notes MCP Serverio.github.docsagent/docsagent623
  5. mumu.micro/mu437
  6. slackcom.pulsemcp/slack80
  7. outlook-assistantio.github.littlebearapps/outlook-assistant37
  8. outlook-mcpio.github.littlebearapps/outlook-mcp37