Icloud Calendar MCP
CalDAV access to Apple iCloud calendars with durable event handles and recurrence support
Icloud Calendar MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 3.3.0
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add icloud-calendar-mcp --env ICLOUD_USERNAME='<ICLOUD_USERNAME>' --env ICLOUD_PASSWORD='<ICLOUD_PASSWORD>' -- npx -y @icloud-calendar-mcp/serverAdd to claude_desktop_config.json
{
"mcpServers": {
"icloud-calendar-mcp": {
"command": "npx",
"args": [
"-y",
"@icloud-calendar-mcp/server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"icloud-calendar-mcp": {
"command": "npx",
"args": [
"-y",
"@icloud-calendar-mcp/server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"icloud-calendar-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@icloud-calendar-mcp/server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"icloud-calendar-mcp": {
"command": "npx",
"args": [
"-y",
"@icloud-calendar-mcp/server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"icloud-calendar-mcp": {
"command": "npx",
"args": [
"-y",
"@icloud-calendar-mcp/server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ICLOUD_USERNAMEYour Apple ID email (e.g., user@icloud.com)RequiredICLOUD_PASSWORDApp-specific password for iCloud (not your main Apple ID password)Required
About Icloud Calendar MCP
Unlike macOS-only calendar bridges, this one talks CalDAV directly and runs wherever Java 21 or newer is installed, even when launched through npx or uvx, since those only download and start the JAR. It needs your Apple ID email and an app-specific password, which the README says should never be your main password.
Five tools list calendars, fetch events in a date range, and create, update and delete events. Event results carry an opaque handle that survives restarts, so an edit or delete needs no re-listing. Recurring series expand into one result per occurrence, and you can change a single occurrence, this-and-future, or the whole series. Date ranges are capped at 366 days and 1000 events, returning a structured error rather than a truncated answer. Dates are interpreted as UTC days.
Three prompt templates handle scheduling a meeting, rescheduling and finding conflicts. Rate limits are 60 reads and 20 writes a minute, and the project cites 282 tests aligned with the OWASP MCP Top 10. iCloud may lag briefly before a new event appears in listings.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- list_calendars
- List all calendars from the iCloud account
- get_events
- Get events within a date range from a calendar
- create_event
- Create a new calendar event
- update_event
- Update an event, whole series or a single occurrence
- delete_event
- Delete an event, whole series or a single occurrence
What it does
- Durable event handles
- Reference events across sessions without re-listing.
- Recurrence editing
- Change one occurrence, this-and-future, or a whole series.
- Bounded responses
- Caps return a clear error instead of truncated data.
- Prompt templates
- Schedule, reschedule and find conflicts.
- Rate limiting
- 60 reads and 20 writes per minute.
- Several install routes
- Run via npx, uvx or a standalone JAR.
Good for
- Ask what is on your calendar this week
- Create a meeting with a colleague tomorrow at 2pm
- Move a 3pm meeting to 4pm
- Find overlapping events on a given day
- Delete a single occurrence of a repeating event
Pricing
Open source
Free and open source; needs an iCloud account
Icloud Calendar MCP FAQ
What credentials does Icloud Calendar MCP need?
An Apple ID email and an app-specific password, not your main Apple ID password.
What does Icloud Calendar MCP require to run?
Java 21 or newer on your PATH, including when using npx or uvx.
Which tools are available?
list_calendars, get_events, create_event, update_event and delete_event.
Why might a new event be missing?
iCloud does not guarantee instant visibility, so a just-created event can be absent from the next listing briefly.
Is Icloud Calendar MCP free?
Yes. Icloud Calendar MCP is open source, so you can use and self-host it for free.
How do I add Icloud Calendar MCP to Claude Code?
Run this command in your terminal: claude mcp add icloud-calendar-mcp --env ICLOUD_USERNAME='<ICLOUD_USERNAME>' --env ICLOUD_PASSWORD='<ICLOUD_PASSWORD>' -- npx -y @icloud-calendar-mcp/server
What are the best alternatives to Icloud Calendar MCP?
The closest alternatives to Icloud Calendar MCP are icloud-mcp, Apple Calendar, Apple Calendar, Pim MCP and iCloud MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.