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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iCloud Calendar MCPshow me my calendar events for the next 7 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: Initial implementation. Offline tests cover access and write controls. Live iCloud access, the full ChatGPT OAuth flow, and devbox deployment are not yet verified.
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: iCloud CalDAV MCP Connector
Access controls
Each installation supports one Apple account and one permitted OAuth subject. 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
See the Cloudflare setup guide. The repository contains a container definition, Compose configuration, a tunnel ingress example, and a non-secret environment template. These files do not deploy or connect an account.
First configure an OAuth issuer, the public hostname, and the permitted subject. Enter the Apple app-specific password only through a secure host setup process. Never enter it in chat. Then test a separate calendar before enabling normal writes.
Next work
Choose and configure the OAuth issuer and exact ChatGPT callback.
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 encrypted secret storage before shared hosting.
Open-source code can be self-hosted per user now. Shared public hosting needs further work.
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.
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
GDPR-compliant calendar access for AI assistants: read, create, edit, RSVP. Google, MS 365, Apple.
Connects ChatGPT to your Apple Calendar via a local Mac agent + Vercel relay
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables users to view and create events in their iCloud Calendar using natural language through supported LLMs. It integrates with Apple's infrastructure via app-specific passwords to provide secure calendar management.1-
- 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
- AlicenseNot gradedqualityFmaintenanceProvider-agnostic CalDAV calendar MCP server that connects any CalDAV calendar to AI assistants, enabling calendar operations like listing, creating, updating, and deleting events.34 PyPIAGPL 3.0
- 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