Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from CALCOM_API_KEY is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration.

​
Setup

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

​
Provider notes

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

​
Tools

​
Verify the connection

Call a read tool such as cal-com__list_bookings with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.