SERVER

iCloud

Rank #2,975

io.github.epinethrone/icloud-mcp

iCloud Mail, Calendar, Contacts, Reminders, Notes and Drive. Approval-first, self-hosted or local.

14 versions

3 GitHub stars

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

First listed

Sep 19, 2026

Last publish date

Sep 26, 2026

OVERVIEW

iCloud is a Model Context Protocol (MCP) server published by epinethrone. It ranks #2,975 of 137,492 servers tracked on MCP Toplist, and its repository has 3 GitHub stars. iCloud is listed across 2 registries — Official MCP and Glama, with 14 tracked versions. It was first listed on Sep 19, 2026 and most recently updated on Sep 26, 2026.

STANDING

#2,975of 137,492 tracked serversTop 5%

Ranks ahead of 134,517 of 137,492 servers on MCP Toplist.

CONNECT

Use iCloud

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_APP_PASSWORD=<your ICLOUD_APP_PASSWORD>" -e "ICLOUD_DISPLAY_NAME=<your ICLOUD_DISPLAY_NAME>" -e "DEFAULT_TIMEZONE=<your DEFAULT_TIMEZONE>" -e "SEND_REQUIRES_APPROVAL=<your SEND_REQUIRES_APPROVAL>" -e "AGENT_NOTES_FILE=<your AGENT_NOTES_FILE>" -e "OWNER_ADDRESSES=<your OWNER_ADDRESSES>" -e "WARMUP_ON_START=<your WARMUP_ON_START>" -e "TOOL_WORKERS=<your TOOL_WORKERS>" -- uvx icloud-mcp-server --local

Replace each placeholder with your own value before saving.

Python package (PyPI)

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

[mcp_servers.icloud-mcp.env]
ICLOUD_USERNAME = "<your ICLOUD_USERNAME>"
ICLOUD_APP_PASSWORD = "<your ICLOUD_APP_PASSWORD>"
ICLOUD_DISPLAY_NAME = "<your ICLOUD_DISPLAY_NAME>"
DEFAULT_TIMEZONE = "<your DEFAULT_TIMEZONE>"
SEND_REQUIRES_APPROVAL = "<your SEND_REQUIRES_APPROVAL>"
AGENT_NOTES_FILE = "<your AGENT_NOTES_FILE>"
OWNER_ADDRESSES = "<your OWNER_ADDRESSES>"
WARMUP_ON_START = "<your WARMUP_ON_START>"
TOOL_WORKERS = "<your TOOL_WORKERS>"

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-server",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "<your ICLOUD_USERNAME>",
        "ICLOUD_APP_PASSWORD": "<your ICLOUD_APP_PASSWORD>",
        "ICLOUD_DISPLAY_NAME": "<your ICLOUD_DISPLAY_NAME>",
        "DEFAULT_TIMEZONE": "<your DEFAULT_TIMEZONE>",
        "SEND_REQUIRES_APPROVAL": "<your SEND_REQUIRES_APPROVAL>",
        "AGENT_NOTES_FILE": "<your AGENT_NOTES_FILE>",
        "OWNER_ADDRESSES": "<your OWNER_ADDRESSES>",
        "WARMUP_ON_START": "<your WARMUP_ON_START>",
        "TOOL_WORKERS": "<your TOOL_WORKERS>"
      }
    }
  }
}

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-server",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "<your ICLOUD_USERNAME>",
        "ICLOUD_APP_PASSWORD": "<your ICLOUD_APP_PASSWORD>",
        "ICLOUD_DISPLAY_NAME": "<your ICLOUD_DISPLAY_NAME>",
        "DEFAULT_TIMEZONE": "<your DEFAULT_TIMEZONE>",
        "SEND_REQUIRES_APPROVAL": "<your SEND_REQUIRES_APPROVAL>",
        "AGENT_NOTES_FILE": "<your AGENT_NOTES_FILE>",
        "OWNER_ADDRESSES": "<your OWNER_ADDRESSES>",
        "WARMUP_ON_START": "<your WARMUP_ON_START>",
        "TOOL_WORKERS": "<your TOOL_WORKERS>"
      }
    }
  }
}

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-server",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "<your ICLOUD_USERNAME>",
        "ICLOUD_APP_PASSWORD": "<your ICLOUD_APP_PASSWORD>",
        "ICLOUD_DISPLAY_NAME": "<your ICLOUD_DISPLAY_NAME>",
        "DEFAULT_TIMEZONE": "<your DEFAULT_TIMEZONE>",
        "SEND_REQUIRES_APPROVAL": "<your SEND_REQUIRES_APPROVAL>",
        "AGENT_NOTES_FILE": "<your AGENT_NOTES_FILE>",
        "OWNER_ADDRESSES": "<your OWNER_ADDRESSES>",
        "WARMUP_ON_START": "<your WARMUP_ON_START>",
        "TOOL_WORKERS": "<your TOOL_WORKERS>"
      }
    }
  }
}

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-server",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "<your ICLOUD_USERNAME>",
        "ICLOUD_APP_PASSWORD": "<your ICLOUD_APP_PASSWORD>",
        "ICLOUD_DISPLAY_NAME": "<your ICLOUD_DISPLAY_NAME>",
        "DEFAULT_TIMEZONE": "<your DEFAULT_TIMEZONE>",
        "SEND_REQUIRES_APPROVAL": "<your SEND_REQUIRES_APPROVAL>",
        "AGENT_NOTES_FILE": "<your AGENT_NOTES_FILE>",
        "OWNER_ADDRESSES": "<your OWNER_ADDRESSES>",
        "WARMUP_ON_START": "<your WARMUP_ON_START>",
        "TOOL_WORKERS": "<your TOOL_WORKERS>"
      }
    }
  }
}

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-server",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "<your ICLOUD_USERNAME>",
        "ICLOUD_APP_PASSWORD": "<your ICLOUD_APP_PASSWORD>",
        "ICLOUD_DISPLAY_NAME": "<your ICLOUD_DISPLAY_NAME>",
        "DEFAULT_TIMEZONE": "<your DEFAULT_TIMEZONE>",
        "SEND_REQUIRES_APPROVAL": "<your SEND_REQUIRES_APPROVAL>",
        "AGENT_NOTES_FILE": "<your AGENT_NOTES_FILE>",
        "OWNER_ADDRESSES": "<your OWNER_ADDRESSES>",
        "WARMUP_ON_START": "<your WARMUP_ON_START>",
        "TOOL_WORKERS": "<your TOOL_WORKERS>"
      }
    }
  }
}

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.epinethrone%2Ficloud-mcp.svg)](https://mcptoplist.com/server/io.github.epinethrone%2Ficloud-mcp)

HTML

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

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

REGISTRIES

Listed on 2 registries

Glama

Official MCP

ORGANIZATION

epinethrone

Organization

epinethrone

Servers in org

Versions across org

VERSIONS

Available versions (14)

Version	Published
0.12.1	Sep 26, 2026
0.12.0	Sep 26, 2026
0.11.0	Sep 25, 2026
0.10.0	Sep 25, 2026
0.9.0	Sep 24, 2026
0.8.0	Sep 24, 2026
0.7.0	Sep 24, 2026
0.6.0	Sep 24, 2026
0.5.0	Sep 24, 2026
0.4.2	Sep 24, 2026
0.4.1	Sep 24, 2026
0.4.0	Sep 24, 2026
0.3.0	Sep 24, 2026
0.2.0	Sep 23, 2026

FAQ

Frequently asked questions

Who maintains iCloud?: iCloud is maintained by epinethrone, which publishes 1 MCP server (14 total versions) tracked on MCP Toplist.
Is iCloud listed on the Official MCP Registry?: Yes — iCloud is listed on the Official MCP Registry, alongside Glama.
How many versions does iCloud have?: MCP Toplist tracks 14 versions of iCloud, most recently published on Sep 26, 2026.
Where can I find the source code for iCloud?: The source code for iCloud is hosted at github.com/epinethrone/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