icloud-mcp

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

stdiocommunityservice

Package Details

icloud-mcp

0.1.1•https://pypi.org/project/icloud-mcp

Transportstdio

Environment Variables

ICLOUD_USERNAME(str)

Required

Your Apple ID email (the IMAP/CalDAV username).

ICLOUD_KEYRING_SERVICE(str)

OS-keyring service name to read the app-specific password from. Default: icloud-mcp. Set to reuse an existing entry.

ICLOUD_APP_PASSWORD(str)

Secret

App-specific password. Fallback only; preferred storage is the OS keyring. Used only when no keyring entry is found.

ICLOUD_ENABLE_WRITES(str)

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(str)

IMAP host override. Default: imap.mail.me.com

ICLOUD_IMAP_PORT(num)

IMAP port override. Default: 993

ICLOUD_SMTP_HOST(str)

SMTP host override (used only by write/send tools). Default: smtp.mail.me.com

ICLOUD_SMTP_PORT(num)

SMTP port override. Default: 587

ICLOUD_CALDAV_URL(str)

CalDAV base URL override. Default: https://caldav.icloud.com/

ICLOUD_CARDDAV_URL(str)

CardDAV base URL override. Default: https://contacts.icloud.com/

ICLOUD_TZ(str)

IANA timezone for rendering/scoping events. Default: system local time.