How to integrate Cal MCP with Claude Code

Tool to create a new attendee for an existing booking in Cal.

Adds a new member to a specified team within an organization by creating a team membership.

Adds a new option to an organization's SINGLE_SELECT or MULTI_SELECT attribute.

Cancels an existing and active Cal.

Retrieves free/busy availability for a specified calendar to aid scheduling without revealing event details; requires an existing, accessible calendar, noting that data granularity can vary.

Call this read-only action to verify the connection and synchronization status of a user's Google Calendar integration with Cal.

Checks an ICS feed URL (expected as a query parameter) to verify its validity, accessibility, and iCalendar data integrity.

Verifies if Stripe is correctly connected to the Cal scheduling system and functional for processing payments, reporting only on the integration's status.

Retrieves the Stripe integration status and related information for a team, primarily to verify account connection, subscription details, or payment setup; this is a read-only operation that does not modify Stripe settings.

Confirms an existing booking by `bookingUid` if the booking exists and is in a state allowing confirmation (e.

Initiates or checks the external connection status for a specified calendar, possibly returning a redirect URL for user authorization to complete integration, without altering calendar data.

Creates a new membership for a user within a Cal.

Creates a new custom attribute for an existing organization, used to enhance data collection for event bookings or user profiles.

Tool to create a new workflow for routing forms within an organization team.

Creates a webhook for an organization that sends HTTP POST notifications to a specified URL when triggered by events (e.

Creates a new team profile, or updates one if a 'slug' matches, customizing branding, scheduling, privacy, and operational details.

Schedules a phone call event in Cal.

Configures Cal.

Creates a new event type for a specified team in Cal.

Creates a highly customizable Cal.

Creates a new team with customizable attributes within an existing and accessible Cal.

Creates a shareable invite link for a Cal.

Adds a user to a team with a specified role, acceptance status, and impersonation settings; ensure `teamId` and `userId` refer to existing, valid entities.

Creates a Cal.

Creates a new schedule defining a user's availability with weekly slots and date-specific overrides in an organization; setting 'isDefault' to true may replace an existing default schedule for the user.

Creates a webhook for an existing `eventTypeId` in Cal.

Declines a pending booking using its bookingUid, optionally with a reason; this action is irreversible and applies only to bookings awaiting confirmation.

Permanently deletes all webhooks associated with a specific team event type.

Disconnects the specified conferencing application (e.

Tool to remove an existing destination calendar by its unique ID.

Permanently deletes an existing event type by its ID, which invalidates its scheduling links; the operation is irreversible, and while existing bookings are unaffected, no new bookings can be made for this event type.

Permanently removes an event type's configuration from a team's scheduling options (e.

Use to permanently remove a user's membership from a specific team within an organization, which revokes their team-associated access but does not remove them from the organization.

Permanently deletes an existing attribute (specified by `attributeId`) from an existing organization (specified by `orgId`); this action is irreversible and may affect features dependent on the attribute.

Permanently deletes a specified option from an organization's attribute.

Irreversibly deletes a user's membership from an organization, removing all associated access and permissions; the response confirms deletion without returning details of the deleted membership.

Permanently deletes an organization-level webhook by its ID.

Permanently deletes a specific schedule using its unique identifier, which must correspond to an existing schedule.

Removes a specified, currently selected calendar from the user's active list within the application, without deleting it from the external provider.

Deletes a previously selected time slot from the Cal schedule using its `uid`; the slot must exist and this action is irreversible.

Permanently and irreversibly deletes an existing team and all its associated data from the Cal system, using the team's unique `teamId`.

Permanently removes a team event type from an organization's scheduling configuration.

Permanently and irreversibly deletes a specific team from a Cal.

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.

Unassigns a specific attribute option from a user within an organization.

Permanently removes a user from a specific organization (user's system-wide account is unaffected), revoking their access rights therein; this action is irreversible via API and expects the user to be a current member.

Permanently deletes a specific user's schedule, provided the organization, user, and schedule (identified by `orgId`, `userId`, and `scheduleId`) exist.

Permanently deletes an existing webhook by its `webhookId`, stopping future notifications; this action is irreversible.

Permanently deletes a specific webhook for an event type, halting its real-time notifications; this operation is irreversible and leaves the event type and other webhooks untouched.

Call this to irreversibly delete all webhooks for a specific `eventTypeId` if the event type exists; details of deleted webhooks are not returned.

Disconnects a calendar integration by its provider name and credential ID, irreversibly revoking Cal's access; external calendar data remains unaffected.

Tool to edit an existing attendee in a Cal.

Tool to edit an existing availability by ID on Cal.

Tool to edit an existing booking by its ID.

Tool to edit an existing Cal.

Tool to edit a selected calendar by its composite ID in Cal.

Fetches a list of bookings, optionally filtered by status, attendee, date range, or by event/team IDs (which must belong to/include the authenticated user respectively), with support for pagination and sorting.

Fetches all configuration settings and characteristics for a single event type (identified by orgId, teamId, and eventTypeId), which must exist and be accessible; this read-only action cannot list, create, or modify event types.

Retrieves a specific attribute of an organization, useful for fetching a single data point instead of the entire organization record.

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.

Fetches comprehensive details for a specific, existing schedule using its `scheduleId`.

Retrieves a specific user's schedule within an organization, returning availability windows, timezone settings, and date-specific overrides.

Retrieves details for a single, specific webhook using its `webhookId` and associated `eventTypeId`.

Retrieves all supported time zone identifiers (e.

Retrieves available time slots for scheduling by considering existing bookings and availability, based on criteria like a specified time range and event type.

Tool to find a specific booking reference by its ID.

Retrieves external references for a specific booking within an organization's team.

Generates an OAuth 2.

Retrieves the Cal system's global default schedule configuration, not custom or user-specific ones.

Tool to retrieve all destination calendars configured for the authenticated user.

Retrieves a specific event type by its ID, requiring that the event type is associated with the given team ID.

Retrieves all private booking links for a specific event type.

Generates the initial Google Calendar OAuth 2.

Retrieves all managed users associated with a Platform OAuth client.

Retrieves all assigned attribute options for a specific attribute within an organization.

Tool to retrieve all assigned attribute options for a specific attribute by its slug within an organization.

Retrieves the organization ID associated with the currently authenticated user from the Cal.

Retrieves availability schedules for an organization.

Retrieves event types, including names, durations, and custom settings for team scheduling, for all teams within an existing organization specified by `orgId`.

Retrieves workflows configured for a specific team within an organization.

Retrieves all availability schedules configured for a specific user within an organization.

Get all private links for a team event type.

Retrieves all availability schedules for a specific user within a team and organization.

Tool to retrieve a selected calendar by its compound ID (userId_integration_externalId).

Retrieves Stripe Connect account details (ID, charges/payouts status, verification, settings) for the user's linked Cal.

Tool to get Stripe Connect authorization URL for a team within an organization.

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.

Retrieves the default conferencing application configured for a specific team within an organization.

Retrieves comprehensive details for a specific team within an organization, including team metadata, configuration settings, branding options, and timezone/week preferences.

Retrieves details for a specific webhook configured on a team event type.

Retrieves all webhooks configured for a specific team event type.

Retrieves detailed information about a specific Cal.

Retrieves routing forms for a specific team within an organization.

Retrieves availability schedules for all members of a specific team within an organization.

Retrieves all teams the user belongs to, including their names and members.

Retrieves a paginated list of verified phone numbers for a specific organization team.

Retrieves details for an existing and accessible webhook by its ID; this is a read-only operation.

Processes an OAuth 2.

Tool to retrieve all attendees from Cal.

Fetches one page of booking references in Cal.

Retrieves Cal event types, filterable by `username` (required if `eventSlug` is provided), multiple `usernames`, or organization details (`orgSlug` or `orgId`).

Retrieves all memberships for a given organization, including user details, roles, status, and membership dates.

Retrieves all event types for a specific team within an organization, optionally filtering by a specific event slug.

Marks the host and/or specified attendees as absent for an existing booking, typically used after a scheduled event to record no-shows.

Updates an organization membership's status (accepted), role, or impersonation settings, identified by `orgId` and `membershipId` in the path; requires at least one of these fields in the request to apply changes.

Partially updates an organization attribute using `orgId` and `attributeId`, allowing modification of its name, slug, type, or enabled status; changing the 'type' may affect existing data.

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.

Partially updates details for a user that exists within the specified organization.

Updates specified details for an existing team identified by `teamId`; unspecified fields remain unchanged.

Updates configuration (e.

Use to submit/update authentication credentials (passed in the request body) for an existing calendar, enabling Cal to connect with external calendar services for synchronization.

Connects or reconnects Cal.

Creates a new booking for an event type at a specified start time.

Assigns an existing attribute option (using `attributeOptionId`) or creates a new one (using `value`) for a user, linking it to a specified `attributeId` which must already exist within the organization.

Links a new external calendar or updates an existing link to one, enabling synchronization with the Cal application by specifying the `integration` provider, the calendar's `externalId`, and the `credentialId`.

Adds a new user to an existing organization (identified by `orgId` in path), requiring user's `email` and allowing extensive optional profile customization.

Creates a new Cal.

Reassigns an existing booking to a specified user.

Reassigns the specified booking to a new team member, who is determined by the system rather than being specified in the request.

Request an email verification code for a team's verified resources.

Reschedules an existing booking (identified by `bookingUid`) to a new time.

Temporarily reserves an available time slot for an existing and bookable event type, useful for high-demand slots to prevent double-bookings while the user completes the booking.

Retrieves all available options for a specific attribute within an organization.

Fetches comprehensive details for an existing booking, identified by its `bookingUid`.

To find busy calendar slots for scheduling/conflict detection, call this with a valid `credentialId`, an `externalId` accessible by it, and a recognized IANA `loggedInUsersTz`; returns only busy intervals, not event details or free slots.

Retrieves a list of all calendar summaries (no event details) associated with the authenticated user's account.

Retrieves details of the team(s) for the currently authenticated user within the specified organization `orgId`.

Retrieves an account's or organization's read-only default conferencing settings in Cal.

Retrieves comprehensive details for a specific, existing Cal.

Retrieves detailed information about a specific membership within a particular organization.

Retrieves the authenticated user's core profile information (e.

Retrieves detailed profile information for a specific managed user associated with an OAuth client.

Retrieves detailed attributes (e.

Retrieves all attribute options assigned to a specific user within an organization.

Retrieves detailed information, including configuration and status, for a specific webhook by its ID (`webhookId`) within a given organization (`orgId`).

Retrieves all webhooks configured for a specific organization, returning an array of webhook objects with their configuration details (ID, triggers, subscriber URL, active status, etc.

Verifies and retrieves details for an OAuth client (provider) in Cal.

Retrieve all availability schedules for the authenticated Cal.

Retrieves a paginated list of teams and their details for a specific organization ID; individual team member details or schedules are not included.

Retrieves event types for a team within the Cal scheduling system; this action does not provide details on scheduled instances or member availability.

Retrieves detailed information for a specific team membership by its ID within an organization's team.

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.

Retrieves all memberships for a team, including member details, roles (MEMBER/OWNER/ADMIN), and invitation acceptance status.

Retrieves all user memberships for a specific team within an organization, including each member's role (OWNER, ADMIN, MEMBER), acceptance status, impersonation settings, and detailed user information (email, username, name, avatar, bio).

Retrieves users associated with a specific organization ID, excluding individual scheduling or calendar data; the `orgId` must be a valid identifier for an existing organization.

Retrieves an authenticated Cal user's or organization's video conferencing configurations, capabilities, and installed apps, useful for understanding options before scheduling or verifying setups; provider availability may vary by subscription or settings.

Retrieves all webhook configurations for a specific OAuth client with optional pagination.

Retrieves a paginated list of webhooks (including URLs, subscribed events, and status) for a specified, existing event type ID, useful for auditing configurations or troubleshooting.

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 bookings, cancellations, or updates.

Saves or updates a calendar's settings using a GET request, typically for data already on the server or simple updates via query parameters.

Imports and saves one or more publicly accessible external iCalendar (ICS) feed URLs into the Cal.

Completes the Google Calendar OAuth 2.

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`.

Sets the specified, valid, and configured conferencing application as the default for new meetings for the authenticated user.

Updates the destination calendar for syncing events, using `integration` and `externalId` (typically from `/calendars` endpoint).

Updates specified profile and scheduling preference fields for a user associated with an OAuth client; `defaultScheduleId`, if provided, must be an existing, valid schedule for the user.

Updates specified properties of an existing webhook for an OAuth client; omitted fields remain unchanged.

Updates a private link for a team event type within an organization.

Updates an existing schedule by its ID, allowing partial modification of properties; providing `availability` or `overrides` replaces them entirely.

Tool to update a team event type in Cal.

Updates a webhook for a team event type.

Updates an existing team's information by its ID within a specified organization; the `slug`, if provided, must be unique within the organization.

Updates properties of an existing team membership.

Updates attributes like acceptance status, role, or impersonation settings for an existing team membership within an organization.

Updates the profile information and preferences for the authenticated user, affecting only the fields provided in the request.

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.

Updates an existing Cal.

Updates an existing webhook for an organization.