> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cal.com

> Manage Cal.com bookings, event types, and availability through the Cal.com API v2

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **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](https://cal.com/docs/api-reference/v2/introduction)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| 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](https://cal.com/docs/api-reference/v2/introduction). |

## Setup

1. **Create a Cal.com account**: Sign up for a free account at [https://cal.com/signup](https://cal.com/signup) (or use your self-hosted instance) and set up at least one event type so there is something to book.
2. **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.
3. **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.

Provider API reference: [https://cal.com/docs/api-reference/v2/introduction](https://cal.com/docs/api-reference/v2/introduction)

## 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.