Apple Reminders & Calendar MCP Server

A Model Context Protocol (MCP) server that integrates Apple Reminders and Apple Calendar with Claude, enabling task management and calendar scheduling directly through conversations.

Built entirely in Swift using EventKit for native, fast, and reliable access.

Features

Reminders / Task Management:

• Create, update, complete, and delete reminders across multiple lists
• Daily planning with list_today_reminders (due today + overdue)
• Priority levels (0=none, 1-4=high, 5=medium, 6-9=low)

Calendar Events:

• Create, update, and delete calendar events
• View today's schedule with list_today_events
• Query events by date range with list_events
• Support for location, URL (video call links), and all-day events

Transport:

• Stdio for local use (Claude Desktop)
• Streamable HTTP for remote access (Claude Web, iOS, etc.)
• API key authentication for HTTP mode

Prerequisites

• macOS 14.0 (Sonoma) or later
• Swift 5.9 or later
• Claude Desktop app (for stdio mode) or any MCP client (for HTTP mode)

Installation

1. Clone this repository
2. Build the Swift package:

swift build -c release

3. The executable will be built at .build/release/apple-events-mcp

Transport Modes

Stdio (default)

For local use with Claude Desktop. No configuration file needed.

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-events": {
      "command": "/absolute/path/to/apple-events-mcp/.build/release/apple-events-mcp"
    }
  }
}

Streamable HTTP

For remote access from Claude Web, Claude iOS, or other MCP clients.

1. Create a config.json in the working directory:

{
  "port": 3030,
  "apiKey": "your-secret-api-key"
}

Generate a secure API key:

openssl rand -hex 32

2. Start the server:

.build/release/apple-events-mcp --http

3. The MCP endpoint will be available at:

POST http://localhost:3030/{apiKey}/mcp

4. Health check (no auth required):

GET http://localhost:3030/health

Important: Use HTTPS in production (e.g., behind a reverse proxy) since the API key is in the URL path.

Permissions

The first time you run this, macOS will prompt you to grant access to both Reminders and Calendar. Click "Allow" for each.

License

MIT