# Icloud Calendar MCP

> Icloud Calendar MCP is an open-source MCP server for productivity. CalDAV access to Apple iCloud calendars with durable event handles and recurrence support. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/icloud-calendar-mcp/icloud-calendar-mcp
- **MCP Registry name:** org.onekash/icloud-calendar-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add icloud-calendar-mcp --env ICLOUD_USERNAME='<ICLOUD_USERNAME>' --env ICLOUD_PASSWORD='<ICLOUD_PASSWORD>' -- npx -y @icloud-calendar-mcp/server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "icloud-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "icloud-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "icloud-calendar-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "icloud-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "icloud-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icloud-calendar-mcp/server"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [icloud-mcp](https://ai-powered.com/mcp/icloud-mcp-3): icloud-mcp is an open-source MCP server for productivity.
- [Apple Calendar](https://ai-powered.com/mcp/apple-calendar-2): Apple Calendar is an open-source MCP server for productivity.
- [Apple Calendar](https://ai-powered.com/mcp/apple-calendar): Apple Calendar is an open-source MCP server for productivity.
- [Pim MCP](https://ai-powered.com/mcp/pim-mcp): Pim MCP is an MCP server for productivity.
- [iCloud MCP](https://ai-powered.com/mcp/icloud-mcp): iCloud MCP is a free MCP server for productivity.
- [MCP for iCloud](https://ai-powered.com/mcp/mcp-for-icloud): MCP for iCloud is an MCP server for productivity.
- [Kalender Sync](https://ai-powered.com/mcp/kalender-sync): Kalender Sync is a freemium MCP server for productivity.
- [SYNCDATE](https://ai-powered.com/mcp/syncdate): SYNCDATE is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/icloud-calendar-mcp
