Cal connector for AI agents

Tools your scheduling agent reaches for on Cal.com, scoped per user.

CALL ANY TOOL

Check availability, create and reschedule bookings, list event types, and cancel meetings, each call scoped to the authenticated user's own calendar access.

calmcp_get_me

Get me

Get the authenticated user's profile including username, email, time zone, default schedule, and organizationId. Call this first when you need the user's own details (email, username, organizationId) for other tools.

Parameters

Name

Type

Required

Description

—

No parameters required

calmcp_update_me

Update me

calmcp_get_booking

Get booking

calmcp_create_booking

Create booking

Create a booking. WORKFLOW: (1) Use get_event_types to find the event type ID/slug. (2) Call get_availability to find open slots : NEVER pick a time without checking availability first. (3) If using bookingFieldsResponses, call get_event_type first to discover required custom fields. (4) For attendee details (name, email, timeZone), use get_me if booking for yourself, otherwise ASK THE USER : never guess or fabricate attendee info. Identify the event type by: eventTypeId, OR eventTypeSlug + username (individual), OR eventTypeSlug + teamSlug (team). The 'start' time MUST be in UTC ISO 8601. 'username' is the HOST whose calendar you are booking. 'attendee' is the GUEST (the caller).

Parameters

Name

Type

Required

Description

attendee

object

Required

Attendee details : the person making the booking (the guest/caller), NOT the host. To book another user's calendar, set their username in the 'username' field and put YOUR (the caller's) details here. NEVER guess or fabricate email addresses : ask the user if unknown.

start

string

Required

Start time in UTC, ISO 8601 (e.g. 2024-08-13T09:00:00Z). Must be UTC.

allowBookingOutOfBounds

boolean

Optional

If true and the authenticated user is a host, allow booking outside the configured scheduling window (e.g. before minimumBookingNotice or beyond the booking window). Ignored for non-hosts.

allowConflicts

boolean

Optional

If true and the authenticated user is a host, skip availability conflict checks. Ignored for non-hosts.

bookingFieldsResponses

object

Optional

Custom booking field responses as {slug: value} pairs

eventTypeId

integer

Optional

Event type ID. Required unless eventTypeSlug + username (or teamSlug) are provided.

eventTypeSlug

string

Optional

Event type slug (e.g. '15min'). Must be combined with username (for individual) or teamSlug (for team).

guests

array

Optional

Additional guest emails to include. Ask the user for guest emails : never guess or fabricate.

lengthInMinutes

integer

Optional

Desired booking length for variable-duration event types. Uses event type default if omitted.

location

object

Optional

Meeting location override as an object. Must match one of the event type's configured location types: {type:'integration',integration:'cal-video'|'google-meet'|'zoom'|...}, {type:'attendeePhone',phone:'+...'}, {type:'attendeeAddress',address:'...'}, {type:'attendeeDefined',location:'...'}, {type:'address'}, {type:'link'}, {type:'phone'}, or {type:'organizersDefaultApp'} (team events only).

metadata

object

Optional

Metadata key-value pairs (max 50 keys, keys ≤40 chars, string values ≤500 chars)

organizationSlug

string

Optional

Organization slug, needed when the user/team is within an organization.

teamSlug

string

Optional

Team slug. Required with eventTypeSlug for team event types.

username

string

Optional

Username of the host whose calendar you are booking on. Required with eventTypeSlug for individual event types.

calmcp_get_bookings

Get bookings

calmcp_create_schedule

Create schedule

calmcp_get_schedule

Get schedule

calmcp_update_schedule

Update schedule

calmcp_get_schedules

Get schedules

calmcp_create_event_type

Create event type

Create a new event type. Required: title, slug, lengthInMinutes. Supports locations, booking fields, buffers, recurrence, confirmation policy, seats, and more.

Parameters

Name

Type

Required

Description

lengthInMinutes

integer

Required

Duration in minutes

slug

string

Required

URL-friendly slug (e.g. '30min')

title

string

Required

Event type title

afterEventBuffer

integer

Optional

Minutes blocked on calendar after the meeting ends.

beforeEventBuffer

integer

Optional

Minutes blocked on calendar before the meeting starts.

bookingFields

array

Optional

Custom fields added to the booking form. Each object defines a field with properties like name, type, label, required, etc.

bookingLimitsCount

object

Optional

Limit how many times this event can be booked per period (e.g. {day: 2, week: 5}).

bookingWindow

object

Optional

Limit how far in the future this event can be booked.

confirmationPolicy

object

Optional

Manual confirmation policy. Controls whether bookings require host confirmation.

customName

string

Optional

Custom event name template with variables: {Event type title}, {Organiser}, {Scheduler}, {Location}.

description

string

Optional

Description shown on the booking page

destinationCalendar

object

Optional

Which external calendar new bookings are added to.

disableGuests

boolean

Optional

If true, bookers cannot add guest emails.

hidden

boolean

Optional

Whether the event type is hidden from the public profile.

hideCalendarNotes

boolean

Optional

Hide calendar notes from the booking.

lengthInMinutesOptions

array

Optional

Multiple duration options the attendee can choose from (e.g. [15, 30, 60]). If provided, the booker picks their preferred duration.

locations

array

Optional

Locations where the event takes place. If not provided, Cal Video is used. Each element is a location object (e.g. {type: 'inPerson', address: '...'}). Note: setting a conferencing app as location requires the app to already be installed.

lockTimeZoneToggleOnBookingPage

boolean

Optional

Lock the timezone on the booking page.

minimumBookingNotice

integer

Optional

Minimum minutes before the event that a booking can be made.

offsetStart

integer

Optional

Offset timeslots shown to bookers by a specified number of minutes.

onlyShowFirstAvailableSlot

boolean

Optional

Limit availability to one slot per day (the earliest available).

recurrence

object

Optional

Recurrence settings to create a recurring event type (e.g. {frequency: 'weekly', interval: 1, occurrences: 12}).

requiresBookerEmailVerification

boolean

Optional

Whether booker must verify their email before the booking is confirmed.

scheduleId

integer

Optional

Use a specific schedule instead of the user's default. Use get_schedules to find schedule IDs.

seats

object

Optional

Enable seated events. Object with seatsPerTimeSlot and other seat settings.

slotInterval

integer

Optional

Length of each slot in minutes. Defaults to the event duration.

successRedirectUrl

string

Optional

URL to redirect the booker to after a successful booking.

calmcp_get_availability

Get availability

calmcp_update_event_type

Update event type

Update an existing event type by ID (use get_event_types to find IDs). Any provided field replaces the current value. Array fields (locations, bookingFields) replace entirely : fetch the current event type first with get_event_type to avoid losing existing values.

Parameters

Name

Type

Required

Description

eventTypeId

integer

Required

Event type ID to update. Use get_event_types to find this.

afterEventBuffer

integer

Optional

Minutes blocked on calendar after the meeting.

beforeEventBuffer

integer

Optional

Minutes blocked on calendar before the meeting.

bookingFields

array

Optional

Updated booking fields array. Replaces ALL existing booking fields. To modify fields, first fetch the current event type with get_event_type, then include all desired fields here.

bookingLimitsCount

object

Optional

Limit how many times this event can be booked per period (e.g. {day: 2, week: 5}).

bookingWindow

object

Optional

Limit how far in the future this event can be booked.

confirmationPolicy

object

Optional

Manual confirmation policy settings.

customName

string

Optional

Custom event name template.

description

string

Optional

New description

destinationCalendar

object

Optional

Which external calendar new bookings are added to.

disableGuests

boolean

Optional

If true, bookers cannot add guest emails.

hidden

boolean

Optional

Whether the event type is hidden.

hideCalendarNotes

boolean

Optional

Hide calendar notes.

lengthInMinutes

integer

Optional

New duration in minutes

lengthInMinutesOptions

array

Optional

Multiple duration options the attendee can choose from (e.g. [15, 30, 60]). If provided, the booker picks their preferred duration.

locations

array

Optional

Updated locations array. Replaces all existing locations.

lockTimeZoneToggleOnBookingPage

boolean

Optional

Lock timezone on booking page.

minimumBookingNotice

integer

Optional

Minimum minutes before event that a booking can be made.

offsetStart

integer

Optional

Offset timeslots by specified minutes.

onlyShowFirstAvailableSlot

boolean

Optional

Show only the earliest available slot per day.

recurrence

object

Optional

Recurrence settings (e.g. {frequency: 'weekly', interval: 1, occurrences: 12}).

requiresBookerEmailVerification

boolean

Optional

Whether booker must verify their email.

scheduleId

integer

Optional

Schedule ID to use instead of default. Use get_schedules to find schedule IDs.

seats

object

Optional

Seated event settings.

slotInterval

integer

Optional

Length of each slot in minutes.

slug

string

Optional

New URL-friendly slug

successRedirectUrl

string

Optional

Redirect URL after successful booking.

title

string

Optional

New title

calmcp_get_busy_times

Get busy times

calmcp_add_booking_attendee

Add booking attendee

calmcp_get_event_type

Get event type

calmcp_create_org_membership

Create org membership

calmcp_get_event_types

Get event types

calmcp_update_org_membership

Update org membership

calmcp_get_org_membership

Get org membership

calmcp_confirm_booking

Confirm booking

calmcp_get_org_memberships

Get org memberships

calmcp_reschedule_booking

Reschedule booking

calmcp_get_booking_attendee

Get booking attendee

calmcp_mark_booking_absent

Mark booking absent

calmcp_get_default_schedule

Get default schedule

calmcp_calculate_routing_form_slots

Calculate routing form slots

calmcp_get_booking_attendees

Get booking attendees

calmcp_cancel_booking

Cancel booking

calmcp_get_conferencing_apps

Get conferencing apps

calmcp_delete_schedule

Delete schedule

Build your Agent

The same per-user auth pattern wires into every agent framework.

import { ScalekitClient } from "@scalekit-sdk/node";
import { ChatOpenAI } from "@langchain/openai";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(process.env.SCALEKIT_ENV_URL, process.env.SCALEKIT_CLIENT_ID, process.env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["calmcp"], toolNames: ["cal_availability_get", "cal_bookings_list", "cal_booking_create"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm: new ChatOpenAI({ model: "gpt-4o" }), tools });
await agent.invoke({ messages: [{ role: "user", content: "Book a 30-minute intro call next week" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const openai = new OpenAI();
const sk = new ScalekitClient(process.env.SCALEKIT_ENV_URL, process.env.SCALEKIT_CLIENT_ID, process.env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["calmcp"], toolNames: ["cal_availability_get", "cal_bookings_list", "cal_booking_create"] },
  pageSize: 100,
});

const res = await openai.responses.create({
  model: "gpt-4o",
  input: "Find an open slot with Priya and book it",
  tools,
});

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const anthropic = new Anthropic();
const sk = new ScalekitClient(process.env.SCALEKIT_ENV_URL, process.env.SCALEKIT_CLIENT_ID, process.env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["calmcp"], toolNames: ["cal_availability_get", "cal_bookings_list", "cal_booking_create"] },
  pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  tools,
  messages: [{ role: "user", content: "Reschedule my Thursday call to next Monday" }],
});

import { LlmAgent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(process.env.SCALEKIT_ENV_URL, process.env.SCALEKIT_CLIENT_ID, process.env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["calmcp"], toolNames: ["cal_availability_get", "cal_bookings_list", "cal_booking_create"] },
  pageSize: 100,
});

const agent = new LlmAgent({ name: "cal_agent", model: "gemini-2.0-flash", tools });
await agent.run("List my upcoming bookings this week");

Try these prompts

Paste any prompt into your agent to start managing Cal.com bookings.

Book & schedule

Copy the prompt

Copied

Find me a 30-minute slot with Priya next week and book it.

Copy the prompt

Copied

Book a discovery call with acme@example.com on Thursday afternoon.

Copy the prompt

Copied

Check my open slots for the intro-call event type next week.

Manage bookings

Copy the prompt

Copied

Reschedule my Thursday 3pm call to next Monday morning.

Copy the prompt

Copied

Cancel the demo booking with globex@example.com and let them know.

Copy the prompt

Copied

Move all my Friday meetings back by 30 minutes.

Report & recall

Copy the prompt

Copied

List all my upcoming bookings this week.

Copy the prompt

Copied

Which event types do I currently offer?

Copy the prompt

Copied

How many meetings did I have last month?

SEE HOW AUTH WORKS

The user authorises Cal.com once. Every later agent call uses their token with calendar scope enforced.

Authorize

Your user connects

Cal MCP

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Cal MCP

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Cal MCP

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Cal MCP

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other calendar connectors.

Support and Ops Teams

Email-to-calendar agent

Reads scheduling intent out of Gmail threads, resolves the times everyone actually has free, and creates the event on the user's own Google Calendar. No shared service account.

Gmail

Google Calendar

View agent

Support and Ops Teams

Meeting prep

Pulls agenda, participant context, and open action items before every meeting.

GTM and RevOps Teams

Sales call prep agent

Reads tomorrow's calls from Google Calendar, mines past Granola notes and Attio history for context, and delivers each rep a prep brief in Slack, scoped to the calls that rep actually owns.

GTM and RevOps Teams

CRM AI agent

Reads the Granola transcript after every call, extracts next steps and updates the HubSpot record, drafts the follow-up in Gmail, and confirms in Slack, all on the rep's own delegated OAuth.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Cal.com token looks fine in a demo. In production every booking and cancel logs as one service account, so you lose track of whose calendar was touched. Scalekit resolves the real user's credential per call.

// shared token
book → scheduling_bot

// scalekit
book → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Cal today. Others tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Cal.com as the user or as a shared key?

As the user. Scalekit resolves the authenticated user's own Cal.com credential at request time, so every booking, reschedule, and cancel is attributed to them in Cal.com rather than a shared scheduling bot.

Where is the Cal.com token stored?

In an AES-256 encrypted vault, namespaced per tenant. Tokens are fetched only at the moment of a tool call, refreshed automatically before expiry, and revocable from a single dashboard, never exposed to the model or the prompt.

Can I limit what the agent is allowed to do in Cal.com?

Yes. Pass a toolNames filter to listScopedTools to expose only the actions you want, for example read-only availability and booking lists without create or cancel. Scalekit also runs a scope check before each API call.

What happens when a user revokes Cal.com access?

The credential is invalidated at the next tool call, which fails closed rather than falling back to a shared token. Other users are unaffected, and the revocation is recorded in the audit trail.

Can the agent book meetings across time zones and event types?

Yes. Availability is resolved against the user's own working hours, buffers, and booking limits, and Cal.com handles timezone detection for each attendee. You choose which event types the agent can book by scoping the toolNames and event type IDs it receives.

On this page

Tool and actions Framework Compatibility Starter Prompt Auth Lifecycle Try Other Agents Why Scalekit