Cal.com
Online scheduling and appointment booking
🔑 Setup Required — Bring Your Own Key
This integration requires API credentials. Store them once via
setup_integration or the Dashboard Vault — they're encrypted
with AES-256-GCM and never exposed.
Required Credentials
calcom_api_key
API Key
Generate an API key at cal.com → Settings → Security → API Keys
Endpoints (5)
GET
get-slots
Get available time slots for a specific event type and date range. Use username + eventSlug for easy lookup, or eventTypeId.
| Field | Type | Required | Description |
|---|---|---|---|
startTime |
string | ✓ Yes | ISO 8601 UTC start, e.g. 2026-05-10T00:00:00Z |
endTime |
string | ✓ Yes | ISO 8601 UTC end, e.g. 2026-05-10T23:59:59Z |
eventTypeId |
integer | No | Cal.com event type ID (alternative to username+slug) |
eventTypeSlug |
string | No | Event slug, e.g. "30min" (use with username) |
username |
string | No | Cal.com username (use with eventTypeSlug) |
POST
create-booking
Create a new booking. Provide event type (by ID or slug+username), start time, and attendee info.
| Field | Type | Required | Description |
|---|---|---|---|
start |
string | ✓ Yes | Booking start time in UTC ISO 8601, e.g. 2026-05-10T14:00:00Z |
eventTypeId |
integer | No | Cal.com event type ID |
eventTypeSlug |
string | No | Event slug (use with username) |
username |
string | No | Cal.com username (use with eventTypeSlug) |
attendee |
object | ✓ Yes | Object with name, email, timeZone, and optionally phoneNumber and language |
guests |
array | No | Array of guest email addresses |
metadata |
object | No | |
lengthInMinutes |
integer | No | Override default event duration |
POST
cancel-booking
Cancel an existing booking by its UID
| Field | Type | Required | Description |
|---|---|---|---|
bookingUid |
string | ✓ Yes | Booking UID returned from create-booking |
cancellationReason |
string | No |
GET
get-booking
Retrieve a specific booking by its UID
| Field | Type | Required | Description |
|---|---|---|---|
bookingUid |
string | ✓ Yes |
GET
list-event-types
List all event types for the authenticated user (e.g. "30 min meeting", "Discovery call")
No input parameters required.
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| get-slots | calcom_get_slots |
| create-booking | calcom_create_booking |
| cancel-booking | calcom_cancel_booking |
| get-booking | calcom_get_booking |
| list-event-types | calcom_list_event_types |