Search / io.github.eodozzy/icloud-mcp
icloud-mcp
L0· runs locallyRead-only-by-default MCP server for iCloud mail, calendar, and contacts (IMAP/CalDAV/CardDAV).
v0.1.1 · active · repository · descriptor JSON · versions
Search / io.github.eodozzy/icloud-mcp
L0· runs locallyRead-only-by-default MCP server for iCloud mail, calendar, and contacts (IMAP/CalDAV/CardDAV).
v0.1.1 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"icloud-mcp": {
"command": "uvx",
"args": [
"icloud-mcp==0.1.1"
],
"env": {
"ICLOUD_USERNAME": "${ICLOUD_USERNAME}",
"ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
}
}
}
}claude mcp add icloud-mcp -e "ICLOUD_USERNAME=${ICLOUD_USERNAME}" -e "ICLOUD_APP_PASSWORD=${ICLOUD_APP_PASSWORD}" -- uvx icloud-mcp==0.1.1[mcp_servers.icloud-mcp]
command = "uvx"
args = ["icloud-mcp==0.1.1"]
env = { "ICLOUD_USERNAME" = "${ICLOUD_USERNAME}", "ICLOUD_APP_PASSWORD" = "${ICLOUD_APP_PASSWORD}" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"icloud-mcp": {
"type": "local",
"command": [
"uvx",
"icloud-mcp==0.1.1"
],
"enabled": true,
"environment": {
"ICLOUD_USERNAME": "{env:ICLOUD_USERNAME}",
"ICLOUD_APP_PASSWORD": "{env:ICLOUD_APP_PASSWORD}"
}
}
}
}{
"mcpServers": {
"icloud-mcp": {
"command": "uvx",
"args": [
"icloud-mcp==0.1.1"
],
"env": {
"ICLOUD_USERNAME": "${ICLOUD_USERNAME}",
"ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=icloud-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJpY2xvdWQtbWNwPT0wLjEuMSJdLCJlbnYiOnsiSUNMT1VEX1VTRVJOQU1FIjoiJHtJQ0xPVURfVVNFUk5BTUV9IiwiSUNMT1VEX0FQUF9QQVNTV09SRCI6IiR7SUNMT1VEX0FQUF9QQVNTV09SRH0ifX0%3D"
}{
"servers": {
"icloud-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"icloud-mcp==0.1.1"
],
"env": {
"ICLOUD_USERNAME": "${ICLOUD_USERNAME}",
"ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
}
}
}
}{
"mcpServers": {
"icloud-mcp": {
"command": "uvx",
"args": [
"icloud-mcp==0.1.1"
],
"env": {
"ICLOUD_USERNAME": "${ICLOUD_USERNAME}",
"ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
}
}
}
}extensions:
"icloud-mcp":
enabled: true
name: "icloud-mcp"
type: stdio
cmd: "uvx"
args:
- "icloud-mcp==0.1.1"
envs:
"ICLOUD_USERNAME": "${ICLOUD_USERNAME}"
"ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
timeout: 300
Placeholders to fill from your own secret store: ${ICLOUD_APP_PASSWORD}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulnsno known advisory in 64 resolved packagesdeps.mcp_sdk_versionmcp 2.2.0, no known advisorydeps.resolvable[email protected] resolved: 64 packagesNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo ~liveness-unmeasured ~updated-112d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] PyPI63 dependencies, resolved · MCP SDK mcp 2.2.0 · advisories checked 2026-10-19
No known advisory affects this dependency graph.
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
icloud-mcp | pypi | 0.1.1 | – | ICLOUD_APP_PASSWORD |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.eodozzy/icloud-mcp",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.1.1",
"packages": [
{
"version": "0.1.1",
"transport": {
"type": "stdio"
},
"identifier": "icloud-mcp",
"registryType": "pypi",
"environmentVariables": [
{
"name": "ICLOUD_USERNAME",
"format": "string",
"isRequired": true,
"description": "Your Apple ID email (the IMAP/CalDAV username)."
},
{
"name": "ICLOUD_KEYRING_SERVICE",
"format": "string",
"description": "OS-keyring service name to read the app-specific password from. Default: icloud-mcp. Set to reuse an existing entry."
},
{
"name": "ICLOUD_APP_PASSWORD",
"format": "string",
"isSecret": true,
"description": "App-specific password. Fallback only; preferred storage is the OS keyring. Used only when no keyring entry is found."
},
{
"name": "ICLOUD_ENABLE_WRITES",
"format": "string",
"description": "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."
},
{
"name": "ICLOUD_IMAP_HOST",
"format": "string",
"description": "IMAP host override. Default: imap.mail.me.com"
},
{
"name": "ICLOUD_IMAP_PORT",
"format": "number",
"description": "IMAP port override. Default: 993"
},
{
"name": "ICLOUD_SMTP_HOST",
"format": "string",
"description": "SMTP host override (used only by write/send tools). Default: smtp.mail.me.com"
},
{
"name": "ICLOUD_SMTP_PORT",
"format": "number",
"description": "SMTP port override. Default: 587"
},
{
"name": "ICLOUD_CALDAV_URL",
"format": "string",
"description": "CalDAV base URL override. Default: https://caldav.icloud.com/"
},
{
"name": "ICLOUD_CARDDAV_URL",
"format": "string",
"description": "CardDAV base URL override. Default: https://contacts.icloud.com/"
},
{
"name": "ICLOUD_TZ",
"format": "string",
"description": "IANA timezone for rendering/scoping events. Default: system local time."
}
]
}
],
"repository": {
"url": "https://github.com/eodozzy/icloud-mcp",
"source": "github"
},
"description": "Read-only-by-default MCP server for iCloud mail, calendar, and contacts (IMAP/CalDAV/CardDAV)."
}