icloud-mcp-server
Integrates with iCloud Calendar via CalDAV, allowing read access by default and optional confirmed writes such as creating, updating, and deleting individual events. Planned iCloud Mail support is read and drafts only: search and read mail, and create drafts, without sending, deleting, or moving mail.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
icloud-mcp-server
A hosted MCP server that lets Claude read, and with your confirmation change, the owner's iCloud Calendar from anywhere: browser, phone, desktop. Say "add dentist Friday 3pm" in a Claude chat and it lands in your calendar after you approve an exact preview. Read-only by default.
Status (2026-11-03): live on Google Cloud Run for one owner, connected to claude.ai. Reads and previewed writes work on the calendars the owner listed. Hardened on the
hardening-2026-11branch (not yet deployed): see docs/reviews/ and docs/FEATURES.md for exactly what is and is not supported.
ChatGPT: the owner uses ChatGPT's native iCloud Calendar and Mail plugins separately. This server no longer ships any ChatGPT-specific setup, callback URLs or roadmap; it serves Claude (generic MCP/OAuth behavior is unchanged).
What it is
Single owner. Sign-in goes through a GitHub OAuth App and only the owner's numeric GitHub ID is accepted (SECURITY.md).
CalDAV to iCloud with an app-specific password kept in Secret Manager. That password cannot be limited to calendar only; read the blast-radius section of docs/DESIGN.md.
Preview, then confirm.
preview_create_event,preview_update_eventandpreview_delete_eventwrite nothing and return an exact preview with a one-time token and anoperation_id.confirm_changeis the only tool that writes; it answersapplied,not_appliedorunknownand never silently retries.Untrusted text is labelled (
untrustedfields, a notice on every result). This reduces prompt-injection risk; it does not remove it.
Related MCP server: icloud-mcp
Not built
A local EventKit mode is not built: helper/ is a placeholder and spike/ only tests macOS Calendar permission. There is no iCloud Mail module (design notes only: docs/MAIL.md), no invitations or RSVP, and this is not full Google Calendar parity.
Develop
uv sync
uv run pytest # offline: fakes plus a local Radicale CalDAV server
uv run ruff check . --extend-ignore EXE002 # EXE002 is exFAT noise on the owner's SSD; CI runs plain `ruff check .`
uv run mypyReal-iCloud tests are opt-in and touch only a calendar named exactly TEST (docs/TESTING.md).
Docs
docs/FEATURES.md: supported, deferred and out-of-scope features
docs/TOOLS.md: tools, schemas, outcome states
docs/DESIGN.md: architecture, trade-offs, blast radius
docs/RUNBOOK-CLOUDRUN.md: first deploy, routine release, rollback
docs/TESTING.md: what is tested and what is not
docs/reviews/: the 2026-11-03 assessment and the improvement prompt
License
MIT. Depends on recurring-ical-events (LGPL-3.0) as an unmodified library; see docs/DESIGN.md.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Read, search and manage iCloud Mail, Calendar and Contacts from Claude and other MCP clients.
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Connect Apple iCloud and Microsoft 365 mail, calendars, contacts and tasks to AI.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access iCloud Calendar, Reminders, and Mail with configurable scope and read-only modes.1MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with read-only access to iCloud mail and calendar via IMAP and CalDAV, with opt-in write support for sending mail, managing events, and contacts.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI assistant to read and search iCloud mail, draft messages (never sent), manage calendar events with a preview/commit gate, and look up contacts via IMAP, CalDAV, and CardDAV.243 npm2MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude and other MCP clients to read, search, and plan events across every calendar account on a Mac, including finding free time, preparing meetings, and creating or moving events, with deletes and changes to shared events requiring user approval. All data stays local via EventKit, and every change can be undone.MIT