Cal.com

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

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.

VariableRequiredDescription
CALCOM_API_KEYYesCal.com API key (starts with cal_ for test mode or cal_live_ for live mode), sent as a Bearer token Docs.

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

ToolAccessDescription
List Bookings<br /><code className="reference-identifier">cal-com__list_bookings</code>ReadList bookings
List Event Types<br /><code className="reference-identifier">cal-com__list_event_types</code>ReadList event types
Get Available Slots<br /><code className="reference-identifier">cal-com__get_available_slots</code>ReadGet available slots
Create Booking<br /><code className="reference-identifier">cal-com__create_booking</code>WriteCreate booking
Get Booking<br /><code className="reference-identifier">cal-com__get_booking</code>ReadGet booking
Reschedule Booking<br /><code className="reference-identifier">cal-com__reschedule_booking</code>WriteReschedule booking
Confirm Booking<br /><code className="reference-identifier">cal-com__confirm_booking</code>WriteConfirm booking
Cancel Booking<br /><code className="reference-identifier">cal-com__cancel_booking</code>WriteCancel booking

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.