cal-com

Cal through One

Cal.com is an open scheduling platform that helps individuals and teams book meetings efficiently by offering customizable, timezone-aware booking links that integrate seamlessly with calendars and workflows.

One exposes Cal through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform cal-com if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Cal is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Cal account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Bookings

Action	Method	Path	Action id
Get a Booking	GET	/bookings/{{bookingUid}}	conn_mod_def::GJ1AA3n_bzA::oRYQy2CjSQW3n_ucn76q0A
Get a Booking by Seat UID	GET	/bookings/by-seat/{{seatUid}}	conn_mod_def::GJ1ABCpRfSc::imUGh_uRTcCAgYV4YwzouQ
Get Calendar Links for a Booking	GET	/bookings/{{bookingUid}}/calendar-links	conn_mod_def::GJ1ABLc7MTc::t-tyD8uPTfGl4ZeW5fQL3w
List a Team’s Bookings	GET	/teams/{{teamId}}/bookings	conn_mod_def::GJ1AjMn7ydk::Utdm1h2OSdWB7fKR3qofdw
List an Organization Team’s Bookings	GET	/organizations/{{orgId}}/teams/{{teamId}}/bookings	conn_mod_def::GJ1AToh4fF8::nYySZbelS8-xDXNMLnqsDA
List an Organization User’s Bookings	GET	/organizations/{{orgId}}/users/{{userId}}/bookings	conn_mod_def::GJ1AdGQPtXQ::tkLainovSOuWfszbab_LHg
List an Organization’s Bookings	GET	/organizations/{{orgId}}/bookings	conn_mod_def::GJ1APHkreVo::0zw7V-bHTgCaOQBvjS0arg
List Bookings	GET	/bookings	conn_mod_def::GJ1ABacT6P4::TQSYRwLQT02RtPGc25_8Qg
Add Guests to a Booking	POST	/bookings/{{bookingUid}}/guests	conn_mod_def::GJ1ADVfo8DA::yF5bzl5qSBOs8ATjZuteKw
Cancel a Booking	POST	/bookings/{{bookingUid}}/cancel	conn_mod_def::GJ1AAJ3FZnc::t5FdItQnR5G-wTdyXg7Yyw
Confirm a Booking	POST	/bookings/{{bookingUid}}/confirm	conn_mod_def::GJ1AASe48L0::YM8pg7eUTtaCT7O6mc-wLQ
Create a Booking	POST	/v2/bookings	conn_mod_def::GJ1AAj_wmBI::YGhi0tsiQrup-PPSYLzi_Q