iCloud Calendar MCP
Provides tools for interacting with iCloud Calendar over CalDAV, including listing calendars, searching and reading events within a limited window, and creating or updating simple timed or all-day events with ETag-based conditional writes.
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 Calendar MCP
A self-hosted iCloud Calendar service for ChatGPT and other remote MCP clients. It uses iCloud CalDAV, OAuth, server-side write controls, and Cloudflare Tunnel.
Status: Personal setup flow deployed on the dev box. Public HTTPS, OAuth discovery, and refusal of unauthenticated MCP access passed on 2026-10-09. Writes are disabled. Offline tests cover the calendar tools, Better Auth code exchange and refresh, encrypted credentials, and access controls. Owner login, iCloud access, and a real ChatGPT connection still need the owner's secure setup and live test.
Tools
Tool | Function |
| Identify the permitted account connection |
| List readable calendars and enabled write operations |
| Read or search a window of at most 93 days |
| Read an event resource and its ETag |
| Create one timed or all-day event |
| Update one simple event with an ETag check |
Recurring events can be read. Their expanded occurrences share the resource event ID;
the recurrence_id identifies an occurrence. This version does not write recurrence,
invitations, RSVP responses, or deletions. Search reports truncation and skipped resources.
Free-time calculation and pagination are planned.
Related MCP server: ical-mcp
Access controls
Each installation supports one iCloud account and one service owner. OAuth grants access to this service. The Apple app-specific password grants the service access to iCloud. These are separate credentials.
The service requires HTTPS configuration, signed tokens for its exact resource,
and calendar:read. Writes also require calendar:write, an exact writable calendar
ID, and an enabled operation. Writes are disabled until the operator sets that policy.
There is no unauthenticated mode. See SECURITY.md.
Develop
Use Python 3.12 or later and uv 0.12.22:
uv sync --locked --extra test
uv run --locked pytest -q
uv run --locked ruff check src testsTests use generated signing keys and fake calendars. They do not access real accounts. The HTTP tests run in memory without a network listener.
Host on the devbox
Start with the personal setup guide. It covers service password login,
secret files, migration, Cloudflare Tunnel, and ChatGPT.
See the deployment record for verified host preparation
and the current setup state.
Use compose.personal.yaml for the new guided flow. It adds a small Better Auth
service beside the existing Python server. The intended MCP URL is
https://cal.ryanmish.com/mcp. No live endpoint is claimed.
Create the one-owner account with a service password. Then connect iCloud with its actual account address and an app-specific password. The next form fills the address from your signup entry or saved connection. You select calendar rights before you approve ChatGPT. This path needs no Apple Developer account. The service password and iCloud password are separate. Optional Apple identity login remains available for installations with the required developer settings.
The original external-issuer guide and compose.yaml remain
available. Do not combine the two Compose files. Never enter Apple credentials
in chat. Test a separate calendar before enabling normal writes.
Reminders research
See Apple Reminders research for existing tools, shared setup, repeat behavior, synchronization limits, and required permissions. This is a proposed extension. Reminders tools are not implemented in this server.
Next work
See current test readiness for the first-login repair, local startup proof, and approved deployment steps. See the deployment record for live verification results.
See cPanel email research for a proposed separate, read-only IMAP adapter. No email connection or tools are enabled.
See the login and iCloud setup research for the Better Auth flow, Apple registration questions, and private ChatGPT setup.
Complete secure host setup and first-owner signup.
Verify the container and Cloudflare route on the devbox.
Verify login and calendar reads with ChatGPT.
Verify conditional writes in a test calendar.
Add free-time calculation, result pagination, and request limits.
Add separate user connections and isolation checks before shared hosting.
The current scope is a personal installation. Shared public hosting needs further work.
The Node service uses Node 24.16.0. Run npm ci, npm run check, npm test, and
npm run build from web/. Tests use fake credentials and an in-memory database.
Sources and license
This service reuses CalDAV discovery and resource code from duanefields/dav-mcp. See THIRD_PARTY_NOTICES.md.
MIT license. This is an independent project. Apple and OpenAI do not endorse it.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read, search and manage iCloud Mail, Calendar and Contacts from Claude and other MCP clients.
Read and send iCloud Mail, manage iCloud Calendar. Needs an approved account at icloud.mcp.visin.ch.
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with iCloud Calendars via the CalDAV protocol using an app-specific password. It allows users to list, create, update, and delete calendar events through MCP-aware clients like ChatGPT.2MIT
- AlicenseAqualityBmaintenanceMCP server for Apple Calendar and CalDAV providers. Enables listing, creating, updating, deleting events, and checking free/busy status with per-calendar write protection.6MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to interact with Apple Calendar locally on macOS through EventKit, including listing calendars and events, creating events, and updating events with privacy-conscious safeguards.MIT
- AlicenseNot gradedqualityBmaintenanceLets AI agents read and write iCloud Calendar events over CalDAV through a self-hosted remote MCP deployment on Cloudflare Workers.MIT