Cal MCP server for AI agents and assistants

Creates an attendee for an existing 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 a 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.

Checks the connection and synchronization status of the authenticated user's Google Calendar integration with Cal.

Calls the ICS feed check endpoint and returns its status.

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

Checks a team's Stripe integration status.

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

Gets an OAuth authorization URL to connect a specified calendar provider to Cal.

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.

Deletes a user's membership from an organization.

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 reserved time slot using its UID, releasing the reservation.

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

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

Retrieves a booking reference by its ID using the Cal.

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

Generates an OAuth 2.

Retrieves the authenticated user's default schedule configuration.

Retrieves the authenticated user's destination calendar from the calendars response, returning it as a single-item list or an empty list when none is configured.

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

Retrieves private booking links for a specific event type, including time-limited or usage-limited links.

Generates the initial Google Calendar OAuth 2.

Lists managed users associated with a Platform OAuth client, with an optional limit on the number returned.

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.

Retrieves private links for a team event type within an organization, including time-based and usage-based links.

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

Retrieves a selected calendar using its user ID, integration and external ID.

Retrieves a Stripe Connect authorization URL for connecting the user's Stripe account to Cal.

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

Retrieves bookings for a specified team, with optional filters, 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 webhooks configured for a specific team event type, with optional pagination using take and skip.

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 teams the user belongs to, including their names and team details.

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.

Retrieves attendees across bookings using the Cal.

Fetches one page of bookings and extracts their references, with caller-driven cursor pagination.

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

Retrieves organization memberships with user details, roles, acceptance status, and custom attributes.

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 Google Meet to Cal.

Creates a 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 the host of a round-robin booking to a specified user.

Reassigns the host of a round-robin or managed event type booking by UID.

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 the authenticated user's default conferencing application settings, including its app identifier and link when available.

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 custom attribute definitions for an organization, with optional pagination.

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 specified organization.

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 team memberships, including roles and invitation acceptance status, with optional member details and pagination via take and skip.

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, with optional pagination and email filtering.

Lists the authenticated user's installed conferencing applications and their connection status.

Retrieves a paginated list of webhook configurations for a specific OAuth client through Cal.

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 Google or Outlook calendar credentials using an authorization code and state for the selected calendar provider.

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 authenticated user's profile information and preferences using the provided fields.

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.