icloud mcp for Claude Desktop

io.github.eodozzy/icloud-mcp

Read-only-by-default MCP server for iCloud mail, calendar, and contacts (IMAP/CalDAV/CardDAV).

client:Claude Desktop transport:stdio runtime:pypi

Install icloud mcp in Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json · windows: %APPDATA%\Claude\claude_desktop_config.json

ICLOUD_USERNAME

ICLOUD_KEYRING_SERVICE

ICLOUD_APP_PASSWORD

ICLOUD_ENABLE_WRITES

ICLOUD_IMAP_HOST

ICLOUD_IMAP_PORT

ICLOUD_SMTP_HOST

ICLOUD_SMTP_PORT

ICLOUD_CALDAV_URL

ICLOUD_CARDDAV_URL

ICLOUD_TZ

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mcp"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_KEYRING_SERVICE": "<ICLOUD_KEYRING_SERVICE>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
        "ICLOUD_ENABLE_WRITES": "<ICLOUD_ENABLE_WRITES>",
        "ICLOUD_IMAP_HOST": "<ICLOUD_IMAP_HOST>",
        "ICLOUD_IMAP_PORT": "<ICLOUD_IMAP_PORT>",
        "ICLOUD_SMTP_HOST": "<ICLOUD_SMTP_HOST>",
        "ICLOUD_SMTP_PORT": "<ICLOUD_SMTP_PORT>",
        "ICLOUD_CALDAV_URL": "<ICLOUD_CALDAV_URL>",
        "ICLOUD_CARDDAV_URL": "<ICLOUD_CARDDAV_URL>",
        "ICLOUD_TZ": "<ICLOUD_TZ>"
      }
    }
  }
}

Settings → Developer → Edit Config opens this file. Restart the app after saving. Claude Desktop docs

icloud mcp in other clients

icloud mcp MCP server