icloud mcp for Grok

io.github.eodozzy/icloud-mcp

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

client:Grok transport:stdio runtime:pypi

Install icloud mcp in Grok

.mcp.json (in your project root)

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>"
      }
    }
  }
}

Grok Build reads Claude Code's .mcp.json and Claude Desktop's config unchanged, so a server you have already set up there needs nothing new. The Grok web app and X integration do not take custom servers. Grok docs

icloud mcp in other clients

icloud mcp MCP server