← Index

io.github.eodozzy/icloud-mcp

io.github.eodozzy/icloud-mcp·v0.1.1·Maps & Location

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

Trust verdict · v1 advisory · method
NOT YET SCREENEDno verdict on file

Verdict not yet evaluated for this tool. The semantic screen takes adversarial cases first; coverage rolls out as the corpus expands (15/150 labels to graduation). The deterministic conformance probe is built but has not yet run on the public corpus, so a recorded verdict here is REVIEW or UNVERIFIED, never a clearing ALLOW. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: the eval, four-state verdict, honest limits.

Own this server? Screen its description →

Environment variables
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.

MCP quality score · maturity, not trust · methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
5
Alternatives in Maps & Location