# @mnicole-dev/calcom-mcp-server

MCP server for the [Cal.com API v2](https://cal.com/docs/api-reference/v2/introduction). 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](https://app.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`:

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

## Development

```bash
pnpm install
pnpm build
CAL_API_KEY=your_key pnpm dev
```