Calendar MCP Server

A pure Swift implementation of a Model Context Protocol (MCP) server that provides native macOS Calendar (EventKit) access to AI assistants like Claude.

Features

• Pure Swift: Single compiled binary with no dependencies
• Native EventKit Integration: Direct access to macOS Calendar
• Simple & Lightweight: ~400KB binary, instant startup
• Zero Configuration: Works out of the box

Available Tools

Event Management

• calendar_list_events - List events within a date range
• calendar_create_event - Create new calendar events
• calendar_get_event - Get detailed information about a specific event
• calendar_update_event - Update existing events
• calendar_delete_event - Delete events
• calendar_search_events - Search for events by title, notes, or location

Calendar Management

• calendar_list_calendars - List all available calendars with details

Prerequisites

• macOS 13.0 or later
• Swift 5.9 or later
• Xcode Command Line Tools

Building

# Clone the repository
git clone https://github.com/alexchambers/calendar-mcp.git
cd calendar-mcp

# Build the server
swift build -c release

# Or use the build script
./build.sh

Installation for Claude Code

1. Build the server (see above)

2. Add to Claude Code using the MCP commands:

   # Remove existing version (if any)
   claude mcp remove calendar-mcp -s user
   
   # Add the server to user space (available in all projects)
   claude mcp add calendar-mcp -s user /path/to/calendar-mcp/.build/release/calendar-mcp
   

3. The server will be available in all your projects

Additional MCP Commands

# List all MCP servers
claude mcp list

# List only user-space servers  
claude mcp list -s user

# Remove from user space
claude mcp remove calendar-mcp -s user

# Add to project-specific space (current project only)
claude mcp add calendar-mcp /path/to/calendar-mcp/.build/release/calendar-mcp

Installation for Claude Desktop

1. Build the server (see above)

2. Add to Claude Desktop configuration:

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

   {
       "mcpServers": {
           "calendar-mcp": {
               "type": "stdio",
               "command": "/path/to/calendar-mcp/.build/release/calendar-mcp"
           }
       }
   }
   

3. Restart Claude Desktop

4. On first use, macOS will prompt for calendar access. Grant permission for the server to work.

Usage Examples

Once installed, you can ask Claude to:

Viewing Events

• "Show me my calendar events for next week"
• "List my events from December 1 to December 15"
• "What's on my calendar today?"
• "Get details for event ID ABC123"

Creating Events

• "Create a meeting titled 'Team Standup' tomorrow from 9:00 to 9:30"
• "Schedule an all-day event called 'Conference' on March 15th"
• "Add a doctor's appointment on Friday at 2pm with location 'Medical Center'"
• "Create a daily recurring meeting at 9am for the next 10 days"
• "Schedule a weekly team meeting every Monday at 2pm"
• "Set up a monthly bill reminder on the 1st of each month"

Managing Events

• "Update the meeting title to 'Daily Standup'"
• "Move my 3pm meeting to 4pm"
• "Delete the event with ID XYZ789"
• "Change the location of my dentist appointment to 'Downtown Clinic'"

Searching Events

• "Find all events with 'meeting' in the title"
• "Search for events containing 'project review' in the next month"
• "Show me all events at 'Conference Room A'"

Calendar Management

• "List all my calendars"
• "Show me which calendars I can create events in"

Recurring Events

• "Create a daily standup meeting for 30 days"
• "Schedule a weekly team meeting every Friday at 3pm"
• "Set up a monthly billing reminder on the 15th"
• "Create a yearly birthday reminder"
• "Schedule a meeting every Tuesday and Thursday at 10am"
• "Set up a quarterly review meeting (every 3 months)"

Tool Refere

... View full README on GitHub