# Apple Calendar

> Apple Calendar is an open-source MCP server for productivity. Local MCP server for Apple Calendar with expanded repeats and free-time lookup. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://cupertino.mgcrea.io
- **Repository:** https://github.com/mgcrea/cupertino/tree/HEAD/packages/calendar
- **MCP Registry name:** io.github.mgcrea/mcp-apple-calendar
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

Calendar reads come from a read-only copy of the Calendar store because Apple Events are slow for ranges: the README measured about 3.4 seconds for a plus-or-minus 90-day query over 1,349 events, against roughly 1 ms to open the store directly. Apple Events are used only for writes, and the package has a test asserting it never gains an Apple Events read path.

Range queries default to 7 days and are capped at 366, which avoids accidental scans of a decade of events. Declined and cancelled events are hidden unless enabled, the default new-event length is 60 minutes, and the time zone can be overridden. Calendars and accounts can be allowlisted, and the three write tools (`create_event`, `update_event`, `delete_events`) exist only when `APPLE_CALENDAR_ALLOW_WRITES=1`.

It is an unofficial server and is not affiliated with Apple.

## Features

- **Fast range reads:** Event lists come from a read-only index, not from slow Apple Events scripts.
- **Bounded ranges:** Default window of 7 days and a ceiling of 366 days.
- **Calendar allowlists:** Limit reads and writes to named calendars or accounts.
- **Opt-in writes:** Create, update and delete tools are unregistered unless enabled.
- **Time zone override:** APPLE_CALENDAR_TIMEZONE changes the zone ranges resolve in.

## Good for

- See what is on next week once repeats are expanded
- Find a free two-hour block before a release
- Search events by keyword
- Keep an agent to a single calendar

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-apple-calendar -- npx -y @mgcrea/mcp-apple-calendar
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-calendar"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-apple-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-calendar"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-apple-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-calendar"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-apple-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-calendar"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-apple-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-calendar"
      ]
    }
  }
}
```

## Tools

- `diagnostics`: Reports which access lane is answering
- `list_accounts`: Lists calendar accounts
- `list_calendars`: Lists calendars
- `list_events`: Lists events in a range
- `search_events`: Searches events
- `get_event`: Reads one event
- `create_event`: Creates an event (writes only)
- `update_event`: Updates an event (writes only)
- `delete_events`: Deletes events (writes only)

## FAQ

### Why not read through Apple Events?

The README measured them as far slower for range queries, so reads use the local index.

### Are declined events shown?

Not by default; APPLE_CALENDAR_INCLUDE_DECLINED turns them on.

### Can it create events?

Yes, once writes are enabled; the default length is 60 minutes.

### Does it need EventKit?

No, the README says it does not.

### Is Apple Calendar free?

Yes. Apple Calendar is open source, so you can use and self-host it for free.

### How do I add Apple Calendar to Claude Code?

Run this command in your terminal: claude mcp add mcp-apple-calendar -- npx -y @mgcrea/mcp-apple-calendar

### What are the best alternatives to Apple Calendar?

The closest alternatives to Apple Calendar are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/apple-calendar-2
