iCloud MCP Server

by mrgo2io.github.MrGo2/icloud-mcpv2.1.3

Apple Mail, Calendar, Contacts, Reminders, Notes, Messages and Safari via AppleScript on macOS, or iCloud over IMAP, CalDAV and CardDAV elsewhere.

61Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained59d ago

Install iCloud MCP server

claude mcp add icloud -e ICLOUD_APP_PASSWORD='<icloud-app-password>' -- npx -y mcp-icloud

{
  "mcpServers": {
    "icloud": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<icloud-app-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "icloud": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<icloud-app-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "icloud": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<icloud-app-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "icloud": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "ICLOUD_APP_PASSWORD": "<icloud-app-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
USE_LOCAL_MODE	—	—	true (default) drives the macOS apps via AppleScript; false uses the iCloud protocols
ICLOUD_EMAIL	—	—	iCloud address, required only for cloud mode
ICLOUD_APP_PASSWORD	—	yes	App-specific password from appleid.apple.com, required only for cloud mode

Freshness

Maintained — last maintenance signal 59d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-11 · 59d ago · GitHub
Latest release
2026-08-11 · 59d ago · GitHub · v2.1.3
Package published
no data · npm/PyPI
Registry entry updated
2026-08-11 · 59d ago · official registry · v2.1.3

FAQ

›How do I install the iCloud MCP server in Claude Code?

Run: claude mcp add icloud -e ICLOUD_APP_PASSWORD='<icloud-app-password>' -- npx -y mcp-icloud. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does iCloud require an API key?

Yes. It expects ICLOUD_APP_PASSWORD, of which 1 is a secret.

›Can I use iCloud as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is iCloud in the official MCP registry?

Yes, as io.github.MrGo2/icloud-mcp.