SERVER

icloud-mcp

Rank #55,116

io.github.eodozzy/icloud-mcp

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

2 versions

1 GitHub stars

by eodozzy (1 servers)View repository ↗Claim this server

Listed & last published

Jun 30, 2026

OVERVIEW

icloud-mcp is a Model Context Protocol (MCP) server published by eodozzy. It ranks #55,116 of 137,138 servers tracked on MCP Toplist, and its repository has 1 GitHub stars. icloud-mcp is listed across 3 registries — Official MCP, PulseMCP and Glama, with 2 tracked versions. It was first listed on Jun 30, 2026 and most recently updated on Jun 30, 2026.

STANDING

#55,116of 137,138 tracked serversTop 50%

Ranks ahead of 82,022 of 137,138 servers on MCP Toplist.

CONNECT

Use icloud-mcp

API keyNeeds credentials

Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.

Python package (PyPI)

claude mcp add icloud-mcp -e "ICLOUD_USERNAME=<your ICLOUD_USERNAME>" -e "ICLOUD_KEYRING_SERVICE=<your ICLOUD_KEYRING_SERVICE>" -e "ICLOUD_APP_PASSWORD=<your ICLOUD_APP_PASSWORD>" -e "ICLOUD_ENABLE_WRITES=<your ICLOUD_ENABLE_WRITES>" -e "ICLOUD_IMAP_HOST=<your ICLOUD_IMAP_HOST>" -e "ICLOUD_IMAP_PORT=<your ICLOUD_IMAP_PORT>" -e "ICLOUD_SMTP_HOST=<your ICLOUD_SMTP_HOST>" -e "ICLOUD_SMTP_PORT=<your ICLOUD_SMTP_PORT>" -e "ICLOUD_CALDAV_URL=<your ICLOUD_CALDAV_URL>" -e "ICLOUD_CARDDAV_URL=<your ICLOUD_CARDDAV_URL>" -e "ICLOUD_TZ=<your ICLOUD_TZ>" -- uvx icloud-mcp

Replace each placeholder with your own value before saving.

Python package (PyPI)

[mcp_servers.icloud-mcp]
command = "uvx"
args = ["icloud-mcp"]

[mcp_servers.icloud-mcp.env]
ICLOUD_USERNAME = "<your ICLOUD_USERNAME>"
ICLOUD_KEYRING_SERVICE = "<your ICLOUD_KEYRING_SERVICE>"
ICLOUD_APP_PASSWORD = "<your ICLOUD_APP_PASSWORD>"
ICLOUD_ENABLE_WRITES = "<your ICLOUD_ENABLE_WRITES>"
ICLOUD_IMAP_HOST = "<your ICLOUD_IMAP_HOST>"
ICLOUD_IMAP_PORT = "<your ICLOUD_IMAP_PORT>"
ICLOUD_SMTP_HOST = "<your ICLOUD_SMTP_HOST>"
ICLOUD_SMTP_PORT = "<your ICLOUD_SMTP_PORT>"
ICLOUD_CALDAV_URL = "<your ICLOUD_CALDAV_URL>"
ICLOUD_CARDDAV_URL = "<your ICLOUD_CARDDAV_URL>"
ICLOUD_TZ = "<your ICLOUD_TZ>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.eodozzy%2Ficloud-mcp.svg)](https://mcptoplist.com/server/io.github.eodozzy%2Ficloud-mcp)

HTML

<a href="https://mcptoplist.com/server/io.github.eodozzy%2Ficloud-mcp"><img src="https://mcptoplist.com/badge/io.github.eodozzy%2Ficloud-mcp.svg" alt="MCP Toplist: Top 50% of 137,138" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 3 registries

PulseMCP

Official MCP

Glama

ORGANIZATION

eodozzy

Organization

eodozzy

Servers in org

Versions across org

VERSIONS

Available versions (2)

Version	Published
0.1.1	Jun 30, 2026
0.1.0	Jun 30, 2026

FAQ

Frequently asked questions

Who maintains icloud-mcp?: icloud-mcp is maintained by eodozzy, which publishes 1 MCP server (2 total versions) tracked on MCP Toplist.
Is icloud-mcp listed on the Official MCP Registry?: Yes — icloud-mcp is listed on the Official MCP Registry, alongside PulseMCP and Glama.
How many versions does icloud-mcp have?: MCP Toplist tracks 2 versions of icloud-mcp, most recently published on Jun 30, 2026.
Where can I find the source code for icloud-mcp?: The source code for icloud-mcp is hosted at github.com/eodozzy/icloud-mcp.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers