cal · 175 tools · no triggers
Connect it
run auth cal
run auth cal --scope team # shared with the organization
Use it
run cal # common commands
run cal --all # every command
import { cal } from "@boxd/run";
Common tools
| Tool | What it does |
|---|---|
add-attendee | Tool to create a new attendee for an existing booking in Cal.com. |
connect-to-calendar | Initiates or checks the external connection status for a specified calendar, possibly returning a redirect URL for user authorization to complete… |
create-or-update-team-profile | Creates a new team profile, or updates one if a ‘slug’ matches, customizing branding, scheduling, privacy, and operational details. |
edit-booking-by-id | Tool to edit an existing booking by its ID. Use when you need to update booking details such as title, description, status, or time. |
edit-event-type-by-id | Tool to edit an existing Cal.com event type by ID. Use when you need to update event type settings like title, description, duration, locations, or… |
get-destination-calendars | Tool to retrieve all destination calendars configured for the authenticated user. |
get-organization-id | Retrieves the organization ID associated with the currently authenticated user from the Cal.com /v2/me endpoint. |
get-team-bookings | Retrieves all bookings for a specified team, optionally filtered by status, attendee details, date ranges, or event type IDs, with support for pagination and sorting. |
get-teams-list | Retrieves all teams the user belongs to, including their names and members. |
list-attendees | Tool to retrieve all attendees from Cal.com. Use when you need to get a complete list of all attendees across all bookings. |
list-event-types | Retrieves Cal event types, filterable by username (required if eventSlug is provided), multiple usernames, or organization details (orgSlug or orgId). |
reserve-slot-for-event | Temporarily reserves an available time slot for an existing and bookable event type, useful for high-demand slots to prevent double-bookings while… |
retrieve-calendar-busy-times | To find busy calendar slots for scheduling/conflict detection, call this with a valid credentialId, an externalId accessible by it, and a… |
retrieve-calendar-list | Retrieves a list of all calendar summaries (no event details) associated with the authenticated user’s account. |
retrieve-my-information | Retrieves the authenticated user’s core profile information (e.g., name, email, timezone); does not retrieve related data like calendar events or schedules. |
retrieve-team-memberships | Retrieves all memberships for a team, including member details, roles (MEMBER/OWNER/ADMIN), and invitation acceptance status. |
retrieve-users-in-organization | Retrieves users associated with a specific organization ID, excluding individual scheduling or calendar data; the orgId must be a valid identifier… |
update-team-event-type | Tool to update a team event type in Cal.com. Use when modifying settings for a team’s event type such as duration, description, scheduling… |
All 175 tools
All 175 tools
| Tool | What it does |
|---|---|
add-attendee | Tool to create a new attendee for an existing booking in Cal.com. |
add-member-to-team-using-org-and-team-id | Adds a new member to a specified team within an organization by creating a team membership. |
add-organization-attribute-option | Adds a new option to an organization’s SINGLE_SELECT or MULTI_SELECT attribute. |
cancel-booking-via-uid | Cancels an existing and active Cal.com booking using its unique identifier (UID). |
check-calendar-version2 | Retrieves free/busy availability for a specified calendar to aid scheduling without revealing event details; requires an existing, accessible… |
check-gsynchronization-status | Call this read-only action to verify the connection and synchronization status of a user’s Google Calendar integration with Cal. |
check-ics-feed-calendar-endpoint | Checks an ICS feed URL (expected as a query parameter) to verify its validity, accessibility, and iCalendar data integrity. |
check-stripe-status | Verifies if Stripe is correctly connected to the Cal scheduling system and functional for processing payments, reporting only on the integration’s status. |
check-team-stripe-integration-status | Retrieves the Stripe integration status and related information for a team, primarily to verify account connection, subscription details, or payment… |
confirm-booking-by-uid | Confirms an existing booking by bookingUid if the booking exists and is in a state allowing confirmation (e.g., not already cancelled or… |
connect-to-calendar | Initiates or checks the external connection status for a specified calendar, possibly returning a redirect URL for user authorization to complete… |
create-membership-for-organization | Creates a new membership for a user within a Cal.com organization. |
create-oauth-client-user | Creates a new managed user for a Cal.com Platform OAuth client. |
create-oauth-client-webhook-configuration | Creates a webhook configuration for an OAuth client to receive real-time event notifications from Cal.com. |
create-organization-attributes | Creates a new custom attribute for an existing organization, used to enhance data collection for event bookings or user profiles. |
create-organization-team-form-workflow | Tool to create a new workflow for routing forms within an organization team. |
create-organization-webhook-by-org-id | Creates a webhook for an organization that sends HTTP POST notifications to a specified URL when triggered by events (e.g., booking created, cancelled, meeting started). |
create-or-update-team-profile | Creates a new team profile, or updates one if a ‘slug’ matches, customizing branding, scheduling, privacy, and operational details. |
create-phone-call-event | Schedules a phone call event in Cal.com using existing eventType, organization, and team IDs; this action only registers the event details and does… |
create-phone-call-for-event-type | Configures Cal.ai phone call automation for a team event type, enabling AI-powered outbound calls for appointment reminders or custom conversations. |
create-team-event-type | Creates a new event type for a specified team in Cal.com; ensure teamId, any provided scheduleId, hosts.userId, and destinationCalendar… |
create-team-event-types-with-custom-options | Creates a highly customizable Cal.com team event type with extensive scheduling, booking, and host assignment options; schedulingType is required… |
create-team-in-organization | Creates a new team with customizable attributes within an existing and accessible Cal.com organization specified by orgId. |
create-team-invite-link | Creates a shareable invite link for a Cal.com team that allows new members to join. |
create-team-membership-with-role | Adds a user to a team with a specified role, acceptance status, and impersonation settings; ensure teamId and userId refer to existing, valid entities. |
create-user-availability-schedule | Creates a Cal.com user availability schedule, defining its name, timezone, weekly recurring availability, and specific date overrides; if isDefault… |
create-user-schedule-in-organization | Creates a new schedule defining a user’s availability with weekly slots and date-specific overrides in an organization; setting ‘isDefault’ to true… |
create-webhook-for-event-type | Creates a webhook for an existing eventTypeId in Cal.com, sending notifications for specified triggers to a subscriberUrl that handles POST requests. |
decline-booking-with-reason | Declines a pending booking using its bookingUid, optionally with a reason; this action is irreversible and applies only to bookings awaiting confirmation. |
delete-all-team-event-type-webhooks | Permanently deletes all webhooks associated with a specific team event type. |
delete-conference-app-connection | Disconnects the specified conferencing application (e.g., ‘zoom’, ‘google_meet’) for the Cal.com account, immediately terminating any ongoing call or… |
delete-destination-calendar-by-id | Tool to remove an existing destination calendar by its unique ID. |
delete-event-type-by-id | Permanently deletes an existing event type by its ID, which invalidates its scheduling links; the operation is irreversible, and while existing… |
delete-event-type-in-team | Permanently removes an event type’s configuration from a team’s scheduling options (e.g., for cleanup); this action is irreversible and requires the… |
delete-membership-in-team | Use to permanently remove a user’s membership from a specific team within an organization, which revokes their team-associated access but does not… |
delete-oauth-client-user | Permanently removes a managed user’s association with an OAuth client without deleting their Cal.com account. |
delete-oauth-client-webhook | Permanently deletes a specific webhook for an OAuth client in Cal.com Platform API. |
delete-organization-attribute | Permanently deletes an existing attribute (specified by attributeId) from an existing organization (specified by orgId); this action is… |
delete-organization-attribute-option | Permanently deletes a specified option from an organization’s attribute. |
delete-organization-membership | Irreversibly deletes a user’s membership from an organization, removing all associated access and permissions; the response confirms deletion without… |
delete-org-webhook | Permanently deletes an organization-level webhook by its ID. |
delete-schedule-by-id | Permanently deletes a specific schedule using its unique identifier, which must correspond to an existing schedule. |
delete-selected-calendars | Removes a specified, currently selected calendar from the user’s active list within the application, without deleting it from the external provider. |
delete-selected-slot | Deletes a previously selected time slot from the Cal schedule using its uid; the slot must exist and this action is irreversible. |
delete-team-by-id | Permanently and irreversibly deletes an existing team and all its associated data from the Cal system, using the team’s unique teamId. |
delete-team-event-type-in-organization | Permanently removes a team event type from an organization’s scheduling configuration. |
delete-team-from-organization | Permanently and irreversibly deletes a specific team from a Cal.com organization. |
delete-team-memberships-by-id | Irreversibly removes a user’s team membership in the Cal application, revoking access to that specific team; the user’s overall Cal account remains active. |
delete-user-attribute-option | Unassigns a specific attribute option from a user within an organization. |
delete-user-from-organization | Permanently removes a user from a specific organization (user’s system-wide account is unaffected), revoking their access rights therein; this action… |
delete-user-schedule | Permanently deletes a specific user’s schedule, provided the organization, user, and schedule (identified by orgId, userId, and scheduleId) exist. |
delete-webhook-by-id | Permanently deletes an existing webhook by its webhookId, stopping future notifications; this action is irreversible. |
delete-webhook-for-event-type | Permanently deletes a specific webhook for an event type, halting its real-time notifications; this operation is irreversible and leaves the event… |
delete-webhooks-for-event-type | Call this to irreversibly delete all webhooks for a specific eventTypeId if the event type exists; details of deleted webhooks are not returned. |
disconnect-calendar-using-credential-id | Disconnects a calendar integration by its provider name and credential ID, irreversibly revoking Cal’s access; external calendar data remains unaffected. |
edit-attendee-by-id | Tool to edit an existing attendee in a Cal.com booking. Use when you need to update attendee details such as name, email, or timezone. |
edit-availability-by-id | Tool to edit an existing availability by ID on Cal.com. Use when you need to update the days, start time, end time, or schedule association of an existing availability. |
edit-booking-by-id | Tool to edit an existing booking by its ID. Use when you need to update booking details such as title, description, status, or time. |
edit-event-type-by-id | Tool to edit an existing Cal.com event type by ID. Use when you need to update event type settings like title, description, duration, locations, or… |
edit-selected-calendar-by-id | Tool to edit a selected calendar by its composite ID in Cal.com. |
fetch-all-bookings | Fetches a list of bookings, optionally filtered by status, attendee, date range, or by event/team IDs (which must belong to/include the authenticated… |
fetch-event-type-details | Fetches all configuration settings and characteristics for a single event type (identified by orgId, teamId, and eventTypeId), which must exist and… |
fetch-organization-attribute-by-id | Retrieves a specific attribute of an organization, useful for fetching a single data point instead of the entire organization record. |
fetch-provider-access-token | Fetches an OAuth access token for the specified clientId to authenticate API calls; this action only retrieves the token, not managing scheduling or calendar events. |
fetch-schedule-by-id | Fetches comprehensive details for a specific, existing schedule using its scheduleId. |
fetch-user-schedule-by-org-id | Retrieves a specific user’s schedule within an organization, returning availability windows, timezone settings, and date-specific overrides. |
fetch-webhook-by-event-type-id | Retrieves details for a single, specific webhook using its webhookId and associated eventTypeId. |
force-refresh-user-oauth-client | Forces an immediate refresh of OAuth tokens for a Platform managed user. |
get-all-timezones | Retrieves all supported time zone identifiers (e.g., ‘America/New_York’, ‘Europe/London’) and their associated metadata, excluding specific DST… |
get-available-slots-info | Retrieves available time slots for scheduling by considering existing bookings and availability, based on criteria like a specified time range and event type. |
get-booking-reference-by-id | Tool to find a specific booking reference by its ID. Use when you need to retrieve details about a single booking reference that links a booking to… |
get-booking-references | Retrieves external references for a specific booking within an organization’s team. |
get-conference-oauth-authorization-url | Generates an OAuth 2.0 authorization URL for a supported conferencing app to initiate or refresh its integration with Cal.com. |
get-default-schedule-details | Retrieves the Cal system’s global default schedule configuration, not custom or user-specific ones. |
get-destination-calendars | Tool to retrieve all destination calendars configured for the authenticated user. |
get-event-type-by-team-id | Retrieves a specific event type by its ID, requiring that the event type is associated with the given team ID. |
get-event-type-private-links | Retrieves all private booking links for a specific event type. |
get-google-calendar-oauth-authentication-url | Generates the initial Google Calendar OAuth 2.0 authorization URL for user redirection to begin the authentication and authorization process. |
get-oauth-clients-user | Retrieves all managed users associated with a Platform OAuth client. |
get-organization-attribute-assigned-options | Retrieves all assigned attribute options for a specific attribute within an organization. |
get-organization-attribute-assigned-options-by-slug | Tool to retrieve all assigned attribute options for a specific attribute by its slug within an organization. |
get-organization-id | Retrieves the organization ID associated with the currently authenticated user from the Cal.com /v2/me endpoint. |
get-organization-schedules | Retrieves availability schedules for an organization. Returns schedules that define when users are available for bookings, including working hours… |
get-organization-teams-event-types | Retrieves event types, including names, durations, and custom settings for team scheduling, for all teams within an existing organization specified by orgId. |
get-organization-team-workflows | Retrieves workflows configured for a specific team within an organization. |
get-organization-user-schedules | Retrieves all availability schedules configured for a specific user within an organization. |
get-private-links | Get all private links for a team event type. Use this to retrieve both time-based (with expiration) and usage-based (with usage limits) private links for scheduling. |
get-schedule-for-user-in-team | Retrieves all availability schedules for a specific user within a team and organization. |
get-selected-calendar-by-id | Tool to retrieve a selected calendar by its compound ID (userId_integration_externalId). |
get-stripe-connect-info | Retrieves Stripe Connect account details (ID, charges/payouts status, verification, settings) for the user’s linked Cal.com account; response may be… |
get-stripe-connect-url | Tool to get Stripe Connect authorization URL for a team within an organization. |
get-team-bookings | Retrieves all bookings for a specified team, optionally filtered by status, attendee details, date ranges, or event type IDs, with support for pagination and sorting. |
get-team-default-conferencing-app | Retrieves the default conferencing application configured for a specific team within an organization. |
get-team-details-by-org-id-and-team-id | Retrieves comprehensive details for a specific team within an organization, including team metadata, configuration settings, branding options, and… |
get-team-event-type-webhook | Retrieves details for a specific webhook configured on a team event type. |
get-team-event-type-webhooks | Retrieves all webhooks configured for a specific team event type. |
get-team-information-by-team-id | Retrieves detailed information about a specific Cal.com team by its ID. |
get-team-routing-forms | Retrieves routing forms for a specific team within an organization. |
get-team-schedules | Retrieves availability schedules for all members of a specific team within an organization. |
get-teams-list | Retrieves all teams the user belongs to, including their names and members. |
get-verified-phone-numbers | Retrieves a paginated list of verified phone numbers for a specific organization team. |
get-webhook-by-id | Retrieves details for an existing and accessible webhook by its ID; this is a read-only operation. |
handle-conferencing-oauth-callback-for-app | Processes an OAuth 2.0 callback for a conferencing app, exchanging the code and state for access credentials; ensure an OAuth flow was previously initiated. |
list-attendees | Tool to retrieve all attendees from Cal.com. Use when you need to get a complete list of all attendees across all bookings. |
list-booking-references | Fetches one page of booking references in Cal.com. The Cal.com v2 API does not expose /booking-references for Bearer-token auth, so this action… |
list-event-types | Retrieves Cal event types, filterable by username (required if eventSlug is provided), multiple usernames, or organization details (orgSlug or orgId). |
list-organization-memberships | Retrieves all memberships for a given organization, including user details, roles, status, and membership dates. |
list-team-event-types-by-org-and-team-id | Retrieves all event types for a specific team within an organization, optionally filtering by a specific event slug. |
mark-booking-absent-for-uid | Marks the host and/or specified attendees as absent for an existing booking, typically used after a scheduled event to record no-shows. |
modify-organization-membership-by-id | Updates an organization membership’s status (accepted), role, or impersonation settings, identified by orgId and membershipId in the path… |
modify-org-attribute-by-id | Partially updates an organization attribute using orgId and attributeId, allowing modification of its name, slug, type, or enabled status… |
patch-organization-attribute-option | Partially updates a specific option for an organization’s attribute, modifying its ‘value’ and/or ‘slug’; at least one of ‘value’ or ‘slug’ must be provided. |
patch-organization-user-details | Partially updates details for a user that exists within the specified organization. |
patch-team-details-by-id | Updates specified details for an existing team identified by teamId; unspecified fields remain unchanged. |
patch-webhook-event-type | Updates configuration (e.g., payload template, active status, URL, triggers, secret) for an existing webhook tied to a specific event type. |
post-calendar-credentials | Use to submit/update authentication credentials (passed in the request body) for an existing calendar, enabling Cal to connect with external calendar… |
post-conferencing-app-connect | Connects or reconnects Cal.com with a specified conferencing application to enable future virtual meeting scheduling, but does not itself create or schedule meetings. |
post-new-booking-request | Creates a new booking for an event type at a specified start time. |
post-org-attribute-option-by-user | Assigns an existing attribute option (using attributeOptionId) or creates a new one (using value) for a user, linking it to a specified… |
post-selected-calendars | Links a new external calendar or updates an existing link to one, enabling synchronization with the Cal application by specifying the integration… |
post-user-to-organization | Adds a new user to an existing organization (identified by orgId in path), requiring user’s email and allowing extensive optional profile customization. |
post-webhook-event | Creates a new Cal.com webhook subscription to send real-time notifications for specified calendar events (like bookings, meetings, forms) to a… |
reassign-booking-to-another-user | Reassigns an existing booking to a specified user. Requires cal-api-version 2024-08-13. |
reassign-booking-with-uid | Reassigns the specified booking to a new team member, who is determined by the system rather than being specified in the request. |
refresh-oauth-token-for-client-id | Refreshes an OAuth access token for a specified clientId and managed user using their refreshToken. |
request-email-verification-code | Request an email verification code for a team’s verified resources. |
reschedule-booking-by-uid | Reschedules an existing booking (identified by bookingUid) to a new time. |
reserve-slot-for-event | Temporarily reserves an available time slot for an existing and bookable event type, useful for high-demand slots to prevent double-bookings while… |
retrieve-attribute-options-for-org | Retrieves all available options for a specific attribute within an organization. |
retrieve-booking-details-by-uid | Fetches comprehensive details for an existing booking, identified by its bookingUid. |
retrieve-calendar-busy-times | To find busy calendar slots for scheduling/conflict detection, call this with a valid credentialId, an externalId accessible by it, and a… |
retrieve-calendar-list | Retrieves a list of all calendar summaries (no event details) associated with the authenticated user’s account. |
retrieve-current-team-for-organization | Retrieves details of the team(s) for the currently authenticated user within the specified organization orgId. |
retrieve-default-conferencing-settings | Retrieves an account’s or organization’s read-only default conferencing settings in Cal.com (e.g., video platform, meeting duration) to inform event… |
retrieve-event-type-by-id | Retrieves comprehensive details for a specific, existing Cal.com event type using its unique ID; this is a read-only action and does not return… |
retrieve-membership-from-organization | Retrieves detailed information about a specific membership within a particular organization. |
retrieve-my-information | Retrieves the authenticated user’s core profile information (e.g., name, email, timezone); does not retrieve related data like calendar events or schedules. |
retrieve-oauth-client-user-by-id | Retrieves detailed profile information for a specific managed user associated with an OAuth client. |
retrieve-oauth-client-webhook-by-id | Retrieves detailed configuration for a specific webhook by ID from a Platform OAuth client. |
retrieve-organization-attributes | Retrieves detailed attributes (e.g., configurations, settings, metadata) for an organization, identified by its orgId, which must correspond to an… |
retrieve-organization-attributes-options | Retrieves all attribute options assigned to a specific user within an organization. |
retrieve-organization-webhook-by-id | Retrieves detailed information, including configuration and status, for a specific webhook by its ID (webhookId) within a given organization (orgId). |
retrieve-organization-webhooks-by-org-id | Retrieves all webhooks configured for a specific organization, returning an array of webhook objects with their configuration details (ID, triggers… |
retrieve-provider-details | Verifies and retrieves details for an OAuth client (provider) in Cal.com’s Platform API. |
retrieve-schedules-list | Retrieve all availability schedules for the authenticated Cal.com user. |
retrieve-team-details-in-organization | Retrieves a paginated list of teams and their details for a specific organization ID; individual team member details or schedules are not included. |
retrieve-team-event-types | Retrieves event types for a team within the Cal scheduling system; this action does not provide details on scheduled instances or member availability. |
retrieve-team-membership-by-id | Retrieves detailed information for a specific team membership by its ID within an organization’s team. |
retrieve-team-membership-details | Retrieves detailed attributes for a specific team membership by its ID and the team ID, such as member information, role, and status; does not list all team members. |
retrieve-team-memberships | Retrieves all memberships for a team, including member details, roles (MEMBER/OWNER/ADMIN), and invitation acceptance status. |
retrieve-team-memberships-for-organization | Retrieves all user memberships for a specific team within an organization, including each member’s role (OWNER, ADMIN, MEMBER), acceptance status… |
retrieve-users-in-organization | Retrieves users associated with a specific organization ID, excluding individual scheduling or calendar data; the orgId must be a valid identifier… |
retrieve-v2-conferencing-info | Retrieves an authenticated Cal user’s or organization’s video conferencing configurations, capabilities, and installed apps, useful for understanding… |
retrieve-webhook-details-for-oauth-client | Retrieves all webhook configurations for a specific OAuth client with optional pagination. |
retrieve-webhooks-for-event-type | Retrieves a paginated list of webhooks (including URLs, subscribed events, and status) for a specified, existing event type ID, useful for auditing… |
retrieve-webhooks-list | Retrieves a paginated list of webhooks from the user’s Cal scheduling system account, which are used for real-time notifications on events like new… |
save-calendar-entry | Saves or updates a calendar’s settings using a GET request, typically for data already on the server or simple updates via query parameters. |
save-calendar-ics-feeds | Imports and saves one or more publicly accessible external iCalendar (ICS) feed URLs into the Cal.com calendar system. |
save-oauth-credentials-via-gapi | Completes the Google Calendar OAuth 2.0 flow by exchanging the code and state (received from Google’s redirect after user consent) for access and refresh tokens. |
save-stripe-details | Completes the Stripe OAuth flow by saving Stripe details; call this when a user is redirected back from Stripe with an authorization code and state. |
set-default-conferencing-app | Sets the specified, valid, and configured conferencing application as the default for new meetings for the authenticated user. |
update-destination-calendar-integration | Updates the destination calendar for syncing events, using integration and externalId (typically from /calendars endpoint). |
update-oauth-client-user-settings | Updates specified profile and scheduling preference fields for a user associated with an OAuth client; defaultScheduleId, if provided, must be an… |
update-oauth-client-webhook | Updates specified properties of an existing webhook for an OAuth client; omitted fields remain unchanged. |
update-private-link | Updates a private link for a team event type within an organization. |
update-schedule-by-id | Updates an existing schedule by its ID, allowing partial modification of properties; providing availability or overrides replaces them entirely. |
update-team-event-type | Tool to update a team event type in Cal.com. Use when modifying settings for a team’s event type such as duration, description, scheduling… |
update-team-event-type-webhook | Updates a webhook for a team event type. Use when you need to modify webhook configuration like active status, subscriber URL, triggers, or payload template. |
update-team-information-by-id | Updates an existing team’s information by its ID within a specified organization; the slug, if provided, must be unique within the organization. |
update-team-membership-by-id | Updates properties of an existing team membership. Supports partial updates - only provided fields are modified while others remain unchanged. |
update-team-membership-properties | Updates attributes like acceptance status, role, or impersonation settings for an existing team membership within an organization. |
update-user-profile-details | Updates the profile information and preferences for the authenticated user, affecting only the fields provided in the request. |
update-user-schedule-in-organization | Modifies an existing schedule for a specified user within an organization by updating only the provided fields; the organization, user, and schedule must already exist. |
update-webhook-by-id | Updates an existing Cal.com webhook by its webhookId, allowing partial modification of its attributes; only explicitly provided fields will be changed. |
update-webhook-for-organization | Updates an existing webhook for an organization. Use this to modify webhook settings such as the subscriber URL, activation status, event triggers… |