icloud mcp for Cursor

io.github.eodozzy/icloud-mcp

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

client:Cursor transport:stdio runtime:pypi

Install icloud mcp in Cursor

~/.cursor/mcp.json · windows: %USERPROFILE%\.cursor\mcp.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": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

Use .cursor/mcp.json in a project root instead to scope it to that project. Cursor merges both. Cursor docs

icloud mcp in other clients

icloud mcp MCP server