At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
CALCOM_API_KEYis sent as theBearerprefixedAuthorizationheader. - Docs: https://cal.com/docs/api-reference/v2/introduction
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
CALCOM_API_KEY | Yes | Cal.com API key (starts with cal_ for test mode or cal_live_ for live mode), sent as a Bearer token Docs. |
Setup
- Create a Cal.com account: Sign up for a free account at https://cal.com/signup (or use your self-hosted instance) and set up at least one event type so there is something to book.
- Generate an API key: In Cal.com, go to Settings > Developer > API Keys and click Add. Give the key a name, optionally set an expiration, and save it.
- Store the key: Copy the generated key into CALCOM_API_KEY. Keys start with cal_ (test) or cal_live_ (live) and are sent as a Bearer token in the Authorization header.
- Most v2 endpoints require a cal-api-version header with a fixed date value that differs per endpoint; the tools set the correct default automatically.
- Booking start times must always be provided in UTC, even when the attendee’s time zone differs.
- API keys are rate limited to 120 requests per minute by default.
Tools
| Tool | Access | Description |
|---|---|---|
| List Bookings | Read | List bookings for the authenticated user with optional status, event type, and attendee filters |
| List Event Types | Read | List event types so the agent can find the event type ID needed for slots and bookings |
| Get Available Slots | Read | Find available time slots for an event type within a date range, e.g. before creating a booking |
| Create Booking | Write | Book a time slot on an event type for an attendee |
| Get Booking | Read | Get a single booking by UID, e.g. to confirm details before rescheduling or cancelling |
| Reschedule Booking | Write | Move an existing booking to a new start time (only accepted or pending bookings can be rescheduled) |
| Confirm Booking | Write | Confirm a booking that is awaiting host approval (status unconfirmed in list_bookings) |
| Cancel Booking | Write | Cancel an existing booking, optionally recording a cancellation reason |
Example prompts
- Show me my upcoming Cal.com bookings and who I’m meeting with.
- Find available time slots on my Cal.com event type for the next few days.
- Book a meeting on my Cal.com event type for an attendee at the next available slot.