iCloud MCP MCP Server

Name: iCloud MCP MCP Server
Author: io.github.MrGo2

io.github.MrGo2/icloud-mcp

Repository Registry

What is the iCloud MCP MCP server?

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

How to install iCloud MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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
secret
App-specific password from appleid.apple.com, required only for cloud mode

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "USE_LOCAL_MODE": "<YOUR_USE_LOCAL_MODE>",
        "ICLOUD_EMAIL": "<YOUR_ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<YOUR_ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "USE_LOCAL_MODE": "<YOUR_USE_LOCAL_MODE>",
        "ICLOUD_EMAIL": "<YOUR_ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<YOUR_ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "USE_LOCAL_MODE": "<YOUR_USE_LOCAL_MODE>",
        "ICLOUD_EMAIL": "<YOUR_ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<YOUR_ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "icloud-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-icloud"
      ],
      "env": {
        "USE_LOCAL_MODE": "<YOUR_USE_LOCAL_MODE>",
        "ICLOUD_EMAIL": "<YOUR_ICLOUD_EMAIL>",
        "ICLOUD_APP_PASSWORD": "<YOUR_ICLOUD_APP_PASSWORD>"
      }
    }
  }
}

Claude Code

claude mcp add icloud-mcp --env USE_LOCAL_MODE=<YOUR_USE_LOCAL_MODE> --env ICLOUD_EMAIL=<YOUR_ICLOUD_EMAIL> --env ICLOUD_APP_PASSWORD=<YOUR_ICLOUD_APP_PASSWORD> -- npx -y mcp-icloud

Related MCP servers

AENA Flights MCP

Active

Flight data for Spain's 50 AENA airports over the public and OAuth2 REST APIs

TypeScript

MIT

View repository →