Content
# @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
```
