Apple EventKit MCP Server

A Model Context Protocol (MCP) server that provides Claude Desktop with access to Apple Calendar and Reminders on macOS.

Features

Calendar Operations

• List calendars: View all available calendars

• List events: Get events within a date range

• Search events: Search by text in title, location, or notes

• Create events: Add new calendar events with location, notes, URL, and tags

• Edit events: Modify existing events (with recurring event support)

• Delete events: Remove events (with recurring event support)

Reminder Operations

• List reminder lists: View all reminder lists

• List reminders: Get reminders with filters (completed, due date)

• Search reminders: Search by text in title or notes

• Create reminders: Add new reminders with due date, priority, and tags

• Edit reminders: Modify existing reminders

• Complete reminders: Mark reminders as done

• Delete reminders: Remove reminders

Tagging System

Since Apple's EventKit doesn't support native tags, this server implements a hashtag-based tagging system. Tags are stored as #hashtags at the end of the notes field and sync via iCloud.

Installation

Prerequisites

• macOS 10.15 or later

• Python 3.10 or later

• uv (recommended) or pip

Step 1: Grant Permissions

Before using the MCP server, you need to grant Calendar and Reminders permissions.

Run the setup script from Terminal:

cd /path/to/apple-eventkit-mcp
uv run python scripts/setup_permissions.py

This will trigger system permission dialogs. Click "OK" to grant access to both Calendar and Reminders.

If dialogs don't appear, manually grant permissions:

1. Open System Settings > Privacy & Security > Calendar

2. Enable access for Terminal (and/or your Python interpreter)

3. Open System Settings > Privacy & Security > Reminders

4. Enable access for Terminal (and/or your Python interpreter)

Step 2: Configure Claude Desktop

Add this server to your Claude Desktop configuration.

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "apple-eventkit": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/apple-eventkit-mcp",
        "run",
        "python",
        "-m",
        "apple_eventkit_mcp.server"
      ]
    }
  }
}

Replace /path/to/uv with the output of which uv and /path/to/apple-eventkit-mcp with your actual installation path.

Step 3: Restart Claude Desktop

Completely quit and restart Claude Desktop. You should see the MCP server indicator (hammer icon) in the chat input area.

Usage Examples

Once configured, you can ask Claude to:

• "Show me my calendar events for this week"

• "Create a meeting titled 'Team Sync' tomorrow at 2pm for 1 hour"

• "List my reminders that are due this week"

• "Create a reminder to 'Review PR' with high priority, due Friday"

• "Search for calendar events containing 'dentist'"

• "Mark my 'Buy groceries' reminder as complete"

Available Tools

Permission Tools

Calendar Tools

Reminder Tools

Troubleshooting

"Permission denied" errors

1. Run the setup script: uv run python scripts/setup_permissions.py

2. If that doesn't work, manually grant permissions in System Settings

3. Make sure Claude Desktop (or the Python interpreter it uses) has access

Server doesn't appear in Claude Desktop

1. Check your JSON configuration for syntax errors

2. Verify the paths are correct (use absolute paths)

3. Check Claude Desktop logs at ~/Library/Logs/Claude/mcp-server-apple-eventkit.log

4. Try running the server manually to test:

   cd /path/to/apple-eventkit-mcp
   uv run python -m apple_eventkit_mcp.server

Events/reminders not showing up

• Check that the correct calendar or reminder list is selected

• iCloud sync may take a moment to reflect changes

• Verify the date range you're querying includes the items

How Tagging Works

Since EventKit doesn't support native tags, this server stores tags as hashtags at the end of the notes field:

Your note content here

#work #high_priority

Tags are:

• Human-readable in Calendar and Reminders apps

• Synced via iCloud with the item

• Searchable by the MCP server

• Automatically normalized (spaces become underscores, lowercase)

License

MIT