Icloud MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add icloud-mcp -e 'ICLOUD_USERNAME=<ICLOUD_USERNAME>' -- uvx icloud-mcp

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mcp"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>"
      }
    }
  }
}

[mcp_servers.icloud-mcp]
command = "uvx"
args = ["icloud-mcp"]
env = { ICLOUD_USERNAME = "<ICLOUD_USERNAME>" }

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mcp"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>"
      }
    }
  }
}

{
  "servers": {
    "icloud-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "icloud-mcp"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>"
      }
    }
  }
}

Put your own value in place of <ICLOUD_USERNAME> (Your Apple ID email (the IMAP/CalDAV username)). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: ICLOUD_KEYRING_SERVICE (OS-keyring service name to read the app-specific password from. Default: icloud-mcp. Set to reuse an existing entry), ICLOUD_APP_PASSWORD (App-specific password. Fallback only; preferred storage is the OS keyring. Used only when no keyring entry is found), ICLOUD_ENABLE_WRITES (Enable mutating tools (send/reply/forward mail, create/update/delete event & contact). Off by default; each write still requires interactive confirmation. Accepts 1/true/yes/on), ICLOUD_IMAP_HOST (IMAP host override. Default: imap.mail.me.com), ICLOUD_IMAP_PORT (IMAP port override. Default: 993), ICLOUD_SMTP_HOST (SMTP host override (used only by write/send tools). Default: smtp.mail.me.com), ICLOUD_SMTP_PORT (SMTP port override. Default: 587), ICLOUD_CALDAV_URL (CalDAV base URL override. Default: https://caldav.icloud.com/), ICLOUD_CARDDAV_URL (CardDAV base URL override. Default: https://contacts.icloud.com/), ICLOUD_TZ (IANA timezone for rendering/scoping events. Default: system local time).