Icloud-mcp Server

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

Local serverstdio

What is the Icloud-mcp Server?

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

Packages and local setup

The published pypi package is icloud-mcp, version 0.1.1. Its declared MCP transport is stdio.

The package declares ICLOUD_USERNAME (required): Your Apple ID email (the IMAP/CalDAV username).; 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..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.1.1 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
ICLOUD_USERNAMEYour Apple ID email (the IMAP/CalDAV username).Yes
ICLOUD_KEYRING_SERVICEOS-keyring service name to read the app-specific password from. Default: icloud-mcp. Set to reuse an existing entry.Optional
ICLOUD_APP_PASSWORDApp-specific password. Fallback only; preferred storage is the OS keyring. Used only when no keyring entry is found.Optional
ICLOUD_ENABLE_WRITESEnable 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.Optional
ICLOUD_IMAP_HOSTIMAP host override. Default: imap.mail.me.comOptional
ICLOUD_IMAP_PORTIMAP port override. Default: 993Optional
ICLOUD_SMTP_HOSTSMTP host override (used only by write/send tools). Default: smtp.mail.me.comOptional
ICLOUD_SMTP_PORTSMTP port override. Default: 587Optional
ICLOUD_CALDAV_URLCalDAV base URL override. Default: https://caldav.icloud.com/Optional
ICLOUD_CARDDAV_URLCardDAV base URL override. Default: https://contacts.icloud.com/Optional
ICLOUD_TZIANA timezone for rendering/scoping events. Default: system local time.Optional