@mnicole-dev/calcom-mcp-server

MCP server for the Cal.com API v2. Provides 24 tools covering bookings, event types, availability slots, schedules, calendars, profile, and out-of-office management.

Tools

Bookings (7)

| Tool | Description | |------|-------------| | list-bookings | List bookings with filters (status, date range, attendee, event type) | | get-booking | Get a booking by UID | | create-booking | Create a new booking | | cancel-booking | Cancel a booking | | reschedule-booking | Reschedule a booking to a new time | | confirm-booking | Confirm a pending booking | | decline-booking | Decline a pending booking |

Event Types (5)

| Tool | Description | |------|-------------| | list-event-types | List all event types | | get-event-type | Get an event type by ID | | create-event-type | Create a new event type | | update-event-type | Update an existing event type | | delete-event-type | Delete an event type |

Slots (1)

| Tool | Description | |------|-------------| | get-available-slots | Get available booking slots within a date range |

Schedules (5)

| Tool | Description | |------|-------------| | list-schedules | List all availability schedules | | get-schedule | Get a schedule by ID | | create-schedule | Create a new availability schedule | | update-schedule | Update a schedule | | delete-schedule | Delete a schedule |

Profile (1)

| Tool | Description | |------|-------------| | get-me | Get the authenticated user profile |

Calendars (2)

| Tool | Description | |------|-------------| | list-calendars | List connected calendars | | get-busy-times | Get busy time blocks from calendars |

Out of Office (3)

| Tool | Description | |------|-------------| | list-out-of-office | List all out-of-office entries | | create-out-of-office | Create an out-of-office entry | | delete-out-of-office | Delete an out-of-office entry |

Setup

Get your API key

1. Log in to Cal.com
2. Go to Settings → Developer → API keys
3. Create a new API key

Configure Claude Desktop

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

{
  "mcpServers": {
    "calcom": {
      "command": "npx",
      "args": ["-y", "@mnicole-dev/calcom-mcp-server"],
      "env": {
        "CAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development

pnpm install
pnpm build
CAL_API_KEY=your_key pnpm dev