View as Markdown
Cal.com icon

Cal.com ACTION

Get All Bookings

Retrieve all bookings from Cal.com. 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 All Bookings 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-all-bookings",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    cal_com: { authProvisionId: "apn_xxxxxxx" },
    status: ["Status"],
    afterStart: "After Start",
  },
})

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 All Bookings inputs
Property Type Description
status Status string[]
Filter bookings by status
Optional
afterStart After Start string
Return bookings that start after this time (ISO 8601)
Optional
beforeEnd Before End string
Return bookings that end before this time (ISO 8601)
Optional
afterCreatedAt After Created At string
Return bookings created after this time (ISO 8601)
Optional
beforeCreatedAt Before Created At string
Return bookings created before this time (ISO 8601)
Optional
attendeeEmail Attendee Email string
Filter bookings by attendee email
Optional
attendeeName Attendee Name string
Filter bookings by attendee name
Optional
bookingUid Booking ID string
Filter bookings by booking UID
Optional Dynamic
eventTypeId Event Type ID integer
Filter bookings by event type ID
Optional Dynamic
sortStart Sort by Start Time string
Sort bookings by start time
Optional
sortEnd Sort by End Time string
Sort bookings by end time
Optional
sortCreated Sort by Created Time string
Sort bookings by creation time
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-all-bookings
Version
1.0.0
App
Cal.com
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes