Skip to content
MCP server

Apple Calendar

Local MCP server for Apple Calendar with expanded repeats and free-time lookup

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
1.40.0
Listing updated
3 days ago

About Apple Calendar

Apple Calendar is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apple-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-calendar"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-apple-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-calendar"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • APPLE_CALENDAR_ALLOW_WRITESRegister the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.
  • APPLE_CALENDAR_CALENDARSRestrict every read and write to these calendars, by name.
  • APPLE_CALENDAR_ACCOUNTSRestrict every read and write to these Calendar accounts, by name or id. Bounds reading, not just writing.

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

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)

What it does

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

Pricing

Open source

MIT-licensed server; the Cupertino companion app lists a 30-minute trial and 30-day refund, prices not published

Prices change. Check cupertino.mgcrea.io before you buy.

Apple Calendar 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 to Apple Calendar

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media