pypi · icloud-mcp
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 · secret — 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.