Apple Calendar
Local MCP server for Apple Calendar with expanded repeats and free-time lookup
- 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-calendarAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-apple-calendar": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-calendar"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-apple-calendar": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-calendar"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media