iCloud runs on your own machine — the client starts it, so there is no endpoint to ping. 234 installs a week from pypi. Last commit 31 Oct 2026.
iCloud Mail, Calendar, Contacts, Reminders, Notes and Drive. Approval-first, self-hosted or local.
What the code does
We read the source, 7 d ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
PLIST="$HOME/Library/LaunchAgents/$LABEL.plist"
return subprocess.run(["git", *args], capture_output=True, text=True, check=True).stdout
let process = Process()
wrap(__import__(mod).Session, "request", "caldav_requests")
+ row("Emptying Trash", value("Allowed" if s.allow_permanent_delete else "Off"))
+ row("Time zone", value(s.default_timezone)) + "</div>")
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
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>' -e 'ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD>' -- uvx icloud-mcp-server{
"mcpServers": {
"icloud-mcp": {
"command": "uvx",
"args": [
"icloud-mcp-server"
],
"env": {
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>"
}
}
}
}[mcp_servers.icloud-mcp]
command = "uvx"
args = ["icloud-mcp-server"]
env = { ICLOUD_USERNAME = "<ICLOUD_USERNAME>", ICLOUD_APP_PASSWORD = "<ICLOUD_APP_PASSWORD>" }{
"mcpServers": {
"icloud-mcp": {
"command": "uvx",
"args": [
"icloud-mcp-server"
],
"env": {
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>"
}
}
}
}{
"servers": {
"icloud-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"icloud-mcp-server"
],
"env": {
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>"
}
}
}
}Put your own values in place of
<ICLOUD_USERNAME> (Your Apple Account email), <ICLOUD_APP_PASSWORD> (An app-specific password from account.apple.com (not your Apple password)).
The author’s registry entry marks them as required.
Optional settings from the registry entry, left out of the block above:
ICLOUD_DISPLAY_NAME (Name shown on mail you send), DEFAULT_TIMEZONE (IANA timezone for calendar times, e.g. Europe/Berlin), SEND_REQUIRES_APPROVAL (true: mail Claude sends is saved to Drafts for you to send. false: sent directly), AGENT_NOTES_FILE (Path to a file with your own rules for agents, added to the instructions), OWNER_ADDRESSES (Your aliases, comma-separated, so invitations to them count as yours), WARMUP_ON_START (Sign in to mail, calendar and contacts in the background at start), TOOL_WORKERS (Tool calls that can run at the same time).
Alternatives to iCloud
same job, measured the same wayPython Proton Mail, Calendar, Contacts and Drive client with an MCP server. Free plan, no Bridge.
Google Workspace MCP server for Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, and more
Drive a self-hosted Darkmoon Pro AI pentest instance: start runs, read campaigns and findings.
Outlook & OneDrive MCP: personal & enterprise tools for mail, calendar, contacts, tasks, files
Gmail, Calendar, Drive, Sheets, Tasks and Contacts for agents, with your own Google login
MCP server for Google Workspace — Sheets, Drive, Docs (HTML or Markdown), Calendar, and Gmail.
Multiple Google accounts (Gmail, Calendar, Drive, Contacts, Tasks) in one Claude connector.
Drive a self-hosted Reelsaw: turn long videos into vertical clips, edit, re-render and export them.
iCloud — questions
Answers built from our own checks of this server.