iCloud MCP

local MCP server

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.

Summary

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

Questions

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

Apple Tools (Unified)io.github.JonathanRReed/apple-tools-mcp18
Mac Shortcuts — read your Mac from any agentio.github.Dominic-DK/mac-shortcuts-mcp14
mcp-apple-notesio.github.henilcalagiya/mcp-apple-notes52
macuseio.github.macuse-app/macuse43
AIquila — Nextcloud MCP Serverio.github.elgorro/aiquila-mcp38
macOS Calendar and Remindersio.github.PsychQuant/che-ical-mcp36
macOS Calendar & Remindersio.github.kiki830621/che-ical-mcp36
remiio.github.mattheworiordan/remi21