Skip to content
MCP server

Apple Calendar

Read and manage Apple Calendar events on macOS, with safety modes and calendar allowlists

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
1.1.7
Listing updated
today

Similar MCP servers

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.

Apple Calendar MCP reaches calendars through EventKit on a Mac and lets an agent list, create, update and delete events while Calendar stays the system of record. When native reads are blocked on supported setups it can fall back to Calendar.app automation.

Three safety modes (safe_readonly, safe_manage, full_access) set what the agent may do, and two allowlists restrict which calendars can be read or written, so an assistant can see your schedule yet write only to a dedicated calendar. Ambiguous calendar names return an error with candidates rather than guessing, and permission guide tools help recover from blocked access.

It runs locally over stdio, via uvx from PyPI or a Claude Desktop bundle.

Install

Run in a terminal

claude mcp add apple-calendar-mcp -- uvx apple-calendar-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "apple-calendar-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-calendar-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "apple-calendar-mcp": {
      "command": "uvx",
      "args": [
        "apple-calendar-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "apple-calendar-mcp": {
      "command": "uvx",
      "args": [
        "apple-calendar-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • APPLE_CALENDAR_MCP_SAFETY_MODESafety mode for Calendar operations: safe_readonly, safe_manage, or full_access.
  • APPLE_CALENDAR_MCP_ALLOWED_CALENDARSComma-separated allow-list of calendar names. Empty allows all calendars.
  • APPLE_CALENDAR_MCP_WRITE_ALLOWED_CALENDARSComma-separated allow-list of calendar names that may be written to (create/update/delete). Reads are unaffected, so a client can see every calendar while only being able to modify these. Empty applies no write-specific restriction.

Tools this server provides (6)

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

calendar_list_calendars
Lists calendars.
calendar_list_events
Lists events.
calendar_create_event
Creates an event.
calendar_update_event
Updates an event.
calendar_permission_guide
Explains how to fix permissions.
calendar_recheck_permissions
Rechecks access.

What it does

Event CRUD
Create, read, update and delete events.
Safety modes
Read-only, manage or full access.
Calendar allowlists
Scope reads and writes to named calendars.
Permission recovery
Guide and recheck tools for blocked access.
Tool discovery
search_tools and get_tool_info for small contexts.
Planning prompts
Today resources and prompts.

Good for

  • Let an assistant add meetings to a dedicated AI calendar
  • Review today's schedule
  • Reschedule events
  • Restrict an agent to read-only

Pricing

Open source

Free; runs locally

Apple Calendar FAQ

Which platform?

macOS.

Default safety mode?

safe_manage.

How to install?

uvx apple-calendar-mcp.

Why use allowlists?

To limit which calendars an agent can read or modify.

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 apple-calendar-mcp -- uvx apple-calendar-mcp

What are the best alternatives to Apple Calendar?

The closest alternatives to Apple Calendar are Ha MCP, Concord MCP, note1, InviteKit Calendar Files and Google Workspace MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers