What is Cal MCP and how does it work?

Cal MCP is a Model Context Protocol connector that integrates Cal.com with AI language models through Ravenala's chat interface. It allows you to manage your calendar using natural conversation instead of traditional UI interactions, supporting all major LLMs.

Which AI models support Cal Connector integration?

Cal Connector works with all major language models including GPT-4, Claude, Gemini, and other LLMs supported by Ravenala. The integration is model-agnostic, so you can switch between different AI assistants while maintaining full calendar functionality.

Can I use Cal AI for team scheduling and collaboration?

Yes, Cal AI excels at team scheduling. You can coordinate group meetings, check multiple team members' availability, send bulk invites, and manage collaborative calendar events through simple conversation with your AI assistant.

Is my Cal.com data secure when using the MCP connection?

Absolutely. The Cal MCP connection uses OAuth authentication and follows enterprise security standards. Your calendar data remains encrypted and is only accessed when you explicitly request actions through the chat interface.

How do I troubleshoot Cal MCP connection issues?

Most connection issues resolve by re-authenticating your Cal account. Click the Connect button, ensure you're logged into Cal.com, and grant the necessary permissions. Contact support if you encounter persistent authentication errors.

Can I schedule recurring meetings with Cal Connector?

Yes, you can create recurring meetings by describing the pattern in natural language. Say something like 'Schedule weekly team standup every Monday at 9 AM' and the AI will set up the recurring series automatically.

Does Cal AI work with different calendar types and event formats?

Cal AI supports all Cal.com event types including one-on-one meetings, group events, round-robin scheduling, and collective availability. It handles different booking workflows and calendar configurations seamlessly through conversation.

What calendar information can I access through Cal MCP chat?

You can view availability, upcoming meetings, booking details, attendee information, and calendar analytics. The AI can also help with time zone conversions, meeting preparation, and scheduling optimization based on your calendar patterns.

How does Cal Connector handle time zones and conflicts?

Cal Connector automatically manages time zones and identifies scheduling conflicts. When booking across time zones, it displays times in each participant's local timezone and prevents double-booking by checking availability in real-time.

Can I customize Cal AI responses and scheduling preferences?

While the AI adapts to your natural language patterns, specific customizations depend on your Cal.com account settings. The connector respects your existing availability preferences, buffer times, and booking rules configured in Cal.com.

Cal

Connect

Tools

Pair Cal with AI models (LLMs)

ChatGPT

By OpenAI

Grok

By xAI

Gemini

By Google

Sonar

By Anthropic

Details

Installs

More than 1000

Actions

140

Triggers

Your guide for Cal

Overview

Transform your calendar management with Cal MCP, the game-changing connector that bridges your Cal.com scheduling platform with any AI model through Ravenala's intuitive chat interface. Skip the endless clicks and complex workflows: simply describe what you need in plain English, and watch as your calendar tasks get handled instantly. Whether you're scheduling meetings, checking availability, or managing bookings, this integration turns tedious calendar admin into effortless conversation.

Say goodbye to switching between multiple tabs and wrestling with scheduling conflicts. Cal MCP brings enterprise-grade calendar intelligence directly into your chat, supporting every major LLM from GPT to Claude to Gemini. Your team can now book meetings, reschedule appointments, and analyze calendar data through natural conversation, making calendar management as simple as asking a colleague for help. Smart scheduling just got smarter.

How to connect Cal MCP

Getting started with Cal MCP is refreshingly straightforward: click on the Connect button on the top right, follow the steps to authenticate with your Cal account, then you're ready to start a new chat and use Cal tools. The entire setup takes less than two minutes, and once connected, your calendar becomes instantly accessible through any supported AI model.

Once connected, managing your calendar becomes as natural as having a conversation. Simply start chatting and ask your AI to check your availability, book meetings, or reschedule appointments using everyday language. The integration handles all the technical complexity behind the scenes, so you can focus on what matters: getting things done efficiently.

Top benefits of using Cal through chat

Natural Language Scheduling

Book meetings by simply saying 'Schedule a team standup for next Tuesday at 2 PM with John and Sarah.' No more navigating complex calendar interfaces or juggling multiple availability windows. Your AI assistant handles the heavy lifting, checking conflicts, sending invites, and confirming details automatically.

Smart Availability Management

Ask questions like 'When am I free this week for a 2-hour deep work session?' and get intelligent responses that consider your preferences, buffer times, and meeting patterns. The AI analyzes your calendar holistically, suggesting optimal time slots that align with your productivity rhythms.

Automated Rescheduling Intelligence

Handle scheduling conflicts effortlessly by telling your AI 'Move my 3 PM meeting to tomorrow and notify attendees.' The system automatically finds suitable alternatives, updates all participants, and maintains your calendar's integrity without the usual back-and-forth email chains.

Cal

Tools

add-member-to-team-using-org-and-team-idAdds a new member to a specified team within an organization by creating a team membership.

add-member-to-team-using-org-and-team-id

add-organization-attribute-optionAdds a new option to an organization's attribute, requiring a display `value` and a `slug` unique for that attribute.

add-organization-attribute-option

cancel-booking-via-uidCancels an existing and active Cal.

cancel-booking-via-uid

check-calendar-version2Retrieves 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.

check-calendar-version2

check-gcal-synchronization-statusCall this read-only action to verify the connection and synchronization status of a user's google Calendar integration with Cal.

check-gcal-synchronization-status

check-ics-feed-calendar-endpointChecks an ics feed url (expected as a query parameter) to verify its validity, accessibility, and iCalendar data integrity.

check-ics-feed-calendar-endpoint

check-stripe-statusVerifies if stripe is correctly connected to the Cal scheduling system and functional for processing payments, reporting only on the integration's status.

check-stripe-status

check-team-stripe-integration-statusRetrieves 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.

check-team-stripe-integration-status

confirm-booking-by-uidConfirms an existing booking by `bookinguid` if the booking exists and is in a state allowing confirmation (e.

confirm-booking-by-uid

connect-to-calendarInitiates 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.

connect-to-calendar

create-membership-for-organizationCreates a new membership or updates an existing one for a user within an organization; the user specified by userid must already exist in the system.

create-membership-for-organization

create-oauth-client-userCreates a new managed user for an oauth client, setting profile and scheduling preferences; if `timezone` is not provided, a default schedule (mon-fri, 9am-5pm) is not created, requiring manual setup via `/schedules` endpoint before bookings are possible.

create-oauth-client-user

create-oauth-client-webhook-configurationCreates a webhook for an existing oauth client to send real-time Cal.

create-oauth-client-webhook-configuration

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

create-organization-attributes

create-organization-webhook-by-org-idCreates a webhook for a specified, existing organization, sending notifications for selected trigger events to a designated, publicly accessible subscriber url that accepts post requests.

create-organization-webhook-by-org-id

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

create-or-update-team-profile

create-phone-call-eventSchedules a phone Call event in Cal.

create-phone-call-event

create-phone-call-for-event-typeCreates a phone Call template associated with an existing event type and team, for defining reusable Call configurations like numbers and scripts; note this does not initiate an actual Call.

create-phone-call-for-event-type

create-team-event-typeCreates a new event type for a specified team in Cal.

create-team-event-type

create-team-event-types-with-custom-optionsCreates a highly customizable Cal.

create-team-event-types-with-custom-options

create-team-in-organizationCreates a new team with customizable attributes within an existing and accessible Cal.

create-team-in-organization

create-team-membership-with-roleAdds a user to a team with a specified role, acceptance status, and impersonation settings; ensure `teamid` and `userid` refer to existing, valid entities.

create-team-membership-with-role

create-user-availability-scheduleCreates a Cal.

create-user-availability-schedule

create-user-schedule-in-organizationCreates 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.

create-user-schedule-in-organization

create-webhook-for-event-typeCreates a webhook for an existing `eventtypeid` in Cal.

create-webhook-for-event-type

decline-booking-with-reasonDeclines a pending booking using its bookinguid, optionally with a reason; this action is irreversible and applies only to bookings awaiting confirmation.

decline-booking-with-reason

delete-conference-app-connectionDisconnects the specified conferencing application (e.

delete-conference-app-connection

delete-event-type-by-idPermanently 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.

delete-event-type-by-id

delete-event-type-in-teamPermanently removes an event type's configuration from a team's scheduling options (e.

delete-event-type-in-team

delete-membership-in-teamUse 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.

delete-membership-in-team

delete-oauth-client-userIrreversibly revokes a specific user's association with a given oauth client, without deleting the user's Cal account.

delete-oauth-client-user

delete-organization-attributePermanently 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.

delete-organization-attribute

delete-organization-attribute-optionPermanently deletes a specified option from an organization's attribute, typiCally to remove an unnecessary configuration choice.

delete-organization-attribute-option

delete-organization-membershipIrreversibly 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.

delete-organization-membership

delete-org-webhookPermanently deletes an organization's webhook, which stops all its notifications; this action is irreversible and the webhook cannot be recovered.

delete-org-webhook

delete-schedule-by-idPermanently deletes a specific schedule using its unique identifier, which must correspond to an existing schedule.

delete-schedule-by-id

delete-selected-calendarsRemoves a specified, currently selected Calendar from the user's active list within the application, without deleting it from the external provider.

delete-selected-calendars

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

delete-selected-slot

delete-team-by-idPermanently and irreversibly deletes an existing team and all its associated data from the Cal system, using the team's unique `teamid`.

delete-team-by-id