View as Markdown
Cal.com icon

Cal.com ACTION

Get Bookable Slots

Retrieve available bookable slots between a datetime range. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Cal.com account once, then configure and run Get Bookable Slots from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "cal_com-get-bookable-slots",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    cal_com: { authProvisionId: "apn_xxxxxxx" },
    start: "Start",
    end: "End",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Bookable Slots inputs
Property Type Description
start Start string
Start date/time in ISO 8601 format (UTC), e.g. 2025-04-01T06:00:00Z
Required
end End string
End date/time in ISO 8601 format (UTC), e.g. 2025-04-07T06:00:00Z
Required
eventTypeId Event Type ID integer
The ID of the event type to get slots for
Optional Dynamic
eventTypeSlug Event Type Slug string
Slug of the event type. Requires username or teamSlug.
Optional
username Username string
Username of the individual event owner
Optional
usernames Usernames string[]
List of at least 2 usernames for a dynamic event (e.g. alice and bob). Sent to the API as a comma-separated string.
Optional
teamSlug Team Slug string
Slug of the team for team event type slot lookup.
Optional
organizationSlug Organization Slug string
Slug of the organization. Optional context for slug-based event type lookup.
Optional
timeZone Time Zone string
The time zone for the booking
Optional
duration Duration (Minutes) integer
Override the default slot duration in minutes
Optional
format Format string
range returns objects with start and end; time returns start times only
Optional
bookingUidToReschedule Booking UID to Reschedule string
UID of the booking being rescheduled. Excludes the original slot from busy calculations.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
cal_com-get-bookable-slots
Version
1.0.1
App
Cal.com
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes