Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Cal.com

Scalekit connector
Open markdown

The Cal.com connector lets your AI agent act in each user's Cal.com account. Each user connects their own Cal.com access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 29 tools.

Tools
29
What they doRead · write · destructive
12 · 14 · 312 read14 write3 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Cal.com connection

    In AgentKit > Connections, create a Cal.com connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'calcom'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Cal.com:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'calcom_bookings_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Cal.com credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • calcom_booking_getGet one booking by its uid.Read-only

    Get Booking

    Get one booking by its uid. For a recurring booking's uid, returns every occurrence. Returns the booking's title, status, start and end times, event type, hosts, attendees, guests, location, meeting URL, and cancellation or reschedule details. Use this when you have the uid; use calcom_bookings_list to find it.

    Inputs

    booking_uidstringrequired
    Unique identifier (uid) of the booking to get. Comes from the uid field returned by calcom_bookings_list or calcom_booking_create. Example: 3sMMoZNJwBMxXT3bm4Mqqm
  • calcom_bookings_listList the authenticated user's bookings, filtered by status, attendee, event type, team, or date range.Read-only

    List Bookings

    List the authenticated user's bookings, filtered by status, attendee, event type, team, or date range. Returns a page of bookings with uid, title, status, start and end times, event type, hosts, attendees, location, and meeting URL, plus pagination.nextCursor for the next page. Use this to find bookings or a booking uid; use calcom_booking_get when you already have the uid. status takes one value; to cover several statuses, call once per status.

    Inputs

    after_created_atstring
    Only return bookings created after this date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
    after_startstring
    Only return bookings that start after this date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
    attendee_emailstring
    Only return bookings with an attendee who has this email address. Example: john@example.com
    attendee_namestring
    Only return bookings with an attendee who has this name. Example: John Smith
    before_created_atstring
    Only return bookings created before this date-time (ISO 8601). Example: 2025-01-31T23:59:59Z
    before_endstring
    Only return bookings that end before this date-time (ISO 8601). Example: 2025-01-31T23:59:59Z
    cursorstring
    Cursor for the next page: pass the pagination.nextCursor value from the previous response. Leave empty for the first page. Example: eyJpZCI6IjEyMyJ9
    event_type_idsstring
    Comma-separated event type IDs; only bookings of these event types are returned. Get IDs from calcom_event_types_list. Example: 1234567,1234568
    limitinteger
    Maximum number of bookings to return per page, 1 to 100. Cal.com returns 50 when not set. Example: 25
    sort_createdstring
    Sort by when the booking was made: asc for oldest first, desc for newest first. Example: descone of ascdesc
    sort_startstring
    Sort by booking start time: asc for earliest first, desc for latest first. Example: ascone of ascdesc
    statusstring
    Only return bookings with this one status: upcoming, recurring, past, cancelled, or unconfirmed. Leave empty for all statuses. To cover several statuses, call once per status. Example: upcomingone of upcomingrecurringpastcancelledunconfirmed
    team_idsstring
    Comma-separated IDs of teams the user belongs to; only bookings of these teams' event types are returned. Example: 101,102
  • calcom_calendars_listList the calendars connected to the authenticated user's Cal.com account, such as Google, Outlook, or Apple calendars.Read-only

    List Connected Calendars

    List the calendars connected to the authenticated user's Cal.com account, such as Google, Outlook, or Apple calendars. Returns each connected calendar app with its credential id and calendars, which ones are checked for conflicts, and the destination calendar for new bookings. Use this to see which calendars Cal.com reads busy times from and writes bookings to.

    Inputs

    This tool takes no inputs.

  • calcom_event_type_getGet one event type by its numeric id.Read-only

    Get Event Type

    Get one event type by its numeric id. Returns the event type's title, slug, length, description, locations, booking fields, schedule id, buffers, and limits. Use this when you have the id; use calcom_event_types_list to find it.

    Inputs

    event_type_idintegerrequired
    Numeric ID of the event type to get. Comes from the id field returned by calcom_event_types_list. Example: 1234567
  • calcom_event_types_listList event types (bookable meeting templates), by default the ones owned by the authenticated user, or a given user's public ones by username.Read-only

    List Event Types

    List event types (bookable meeting templates), by default the ones owned by the authenticated user, or a given user's public ones by username. Returns each event type's id, title, slug, length in minutes, locations, booking fields, and scheduling settings. Use this to find an event type id to book, check slots for, or update; use calcom_event_type_get when you already have the id.

    Inputs

    event_slugstring
    Slug of a single event type to return, for example the last part of cal.com/janedoe/30min. Requires username as well, because different users can have event types with the same slug. Example: 30min
    org_idinteger
    Numeric ID of the user's organization, when the user belongs to a Cal.com organization. Use this or org_slug, not both. Example: 42
    org_slugstring
    Slug of the user's organization, when the user belongs to a Cal.com organization. Use this or org_id, not both. Example: acme
    sort_created_atstring
    Order results by creation date: asc for oldest first, desc for newest first. Leave empty for no explicit order. Example: descone of ascdesc
    usernamestring
    Username of the Cal.com user whose event types to return. Leave empty to list the authenticated user's own event types. Example: janedoe
    usernamesstring
    Comma-separated usernames to get the dynamic group event type for several users at once. Example: alice,bob
  • calcom_me_getGet the profile of the Cal.com user who owns the API key.Read-only

    Get My Profile

    Get the profile of the Cal.com user who owns the API key. Returns the user's id, username, email, name, time zone, week start, time format, default schedule id, and organization id. Use this to find the account's username, time zone, or default schedule before listing event types, checking slots, or booking; use calcom_me_update to change these settings.

    Inputs

    This tool takes no inputs.

  • calcom_schedule_default_getGet the authenticated user's default availability schedule, used by event types that have no schedule of their own.Read-only

    Get Default Schedule

    Get the authenticated user's default availability schedule, used by event types that have no schedule of their own. Returns the schedule's id, name, time zone, weekly availability, and date overrides. Use this to see the user's normal working hours; use calcom_schedules_list to see all schedules.

    Inputs

    This tool takes no inputs.

  • calcom_schedule_getGet one availability schedule by its id.Read-only

    Get Schedule

    Get one availability schedule by its id. Returns the schedule's name, time zone, whether it is the default, weekly availability, and date overrides. Use this when you have the id; use calcom_schedules_list to find it.

    Inputs

    schedule_idintegerrequired
    Numeric ID of the availability schedule to get. Comes from the id field returned by calcom_schedules_list. Example: 123456