Cal.com

At a glance

Availability: Experimental (how to enable).
Auth: API key.
Connection: The key from CALCOM_API_KEY is sent as the Bearer prefixed Authorization header.
Docs: https://cal.com/docs/api-reference/v2/introduction

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.

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.

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

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.