Kenso MCP tools

Scheduler scheduler

Meeting types, Scheduler links and bookings for members' Scheduler pages: list meeting types and their open times, make a person's prefilled link or a single-use link, list or read bookings, mark a booking as a no-show, and reassign or cancel the upcoming bookings of a member who left. Needs the scheduler feature.

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through scheduler_read and changes through scheduler_write. Each takes operation plus that operation's parameters, and your workspace role decides which operations you see.

Each operation with a route calls the Kenso API at https://api.ken.so with Authorization: Bearer <Kenso API key>, Ken-Version: 1.1 and X-Ken-Workspace-Id: <workspace id>. You can call that route directly with the same headers.

Operations: bookings-bulk-cancel, bookings-bulk-reassign, links-create, booking-defaults-get, bookings-get, external-bookings-get, links-list, bookings-list, external-bookings-list, meeting-types-list, bookings-no-show, meeting-types-slots, links-suggested-times, booking-defaults-update, links-update

bookings-bulk-cancel

Write. POST https://api.ken.so/v1/bookings/bulk-cancel

Body (json): cursor string, hostMemberId integer

Cancel the upcoming bookings of a member who left.

POST /api/v1/bookings/bulk-cancel. Public. Sends Ken-Version 1.1. Needs the scheduler feature,
the Calendar page (view) and the members feature (admins). client_id is sent as X-Ken-Workspace-Id.

host_member_id is the member who left (409 invalid_state while they are still a member). Each call
handles the next 20 upcoming bookings: each booking's event is removed from the former member's
calendar and the booking is cancelled as a workspace cancel. The calendar tells the booker only
when calendarEventRemoved is true. A cancelled booking whose invite stayed on the former member's
calendar has errorCode booker_not_told and counts in failed: tell the booker yourself.
Repeating a call is safe.

Returns {data: {succeeded, failed, results: [{bookingId, status, startAt, newBookingId,
hostMemberId, calendarEventRemoved, error?, errorCode?}], hasMore, nextCursor}}. status is
cancelled, already_handled, host_busy, calendar_write_failed or failed. While hasMore, call again
with cursor=nextCursor.

bookings-bulk-reassign

Write. POST https://api.ken.so/v1/bookings/bulk-reassign

Body (json): cursor string, hostMemberId integer

Reassign the upcoming bookings of a member who left to free teammates at the same time.

POST /api/v1/bookings/bulk-reassign. Public. Sends Ken-Version 1.1. Needs the scheduler feature,
the Calendar page (view) and the members feature (admins). client_id is sent as X-Ken-Workspace-Id.

host_member_id is the member who left (409 invalid_state while they are still a member). Each call
handles the next 20 upcoming bookings: each moves to a free member at the same time (the account
owner, then the campaign sender, then the meeting type's team, then anyone with a meeting type on),
the new host's calendar sends the invite and the old event is cancelled from the former member's
calendar. A booking with no free member stays and is listed. Repeating a call is safe.

Returns {data: {succeeded, failed, results: [{bookingId, status, startAt, newBookingId,
hostMemberId, calendarEventRemoved, error?}], hasMore, nextCursor}}. status is reassigned,
already_handled, no_free_member, host_busy, calendar_write_failed or failed. While hasMore, call
again with cursor=nextCursor.

Write. POST https://api.ken.so/v1/booking-links

Body (json): accountId integer, assetId integer, availability object, campaignId integer, channel string, hostMemberId integer, kind string, meetingTypeId integer, personId integer, senderAddress string, source string, stepOrder integer, touchId integer

Make a Scheduler link: a person's prefilled link, or a single-use link.

POST /api/v1/booking-links. Needs the scheduler feature and Calendar view, and never a client seat
(403 permission_denied whatever its template grants). Sends Ken-Version 1.1.
kind=person (person_id required) returns the same link for the same person and campaign (or Studio
page, or source and host) every time; the page opens with the person's details filled in.
kind=single_use returns a new /s/ link that books once and expires after 30 days; meeting_type_id
defaults to the host's default type. meeting_type_id or host_member_id pick the page: a member links
only to their own page and types, an admin to anyone's. Attribution: account_id, campaign_id with
step_order, touch_id, asset_id (a Studio page), source (personal, campaign, reply, studio) and
channel (email, linkedin, web); account_id and touch_id must be the person's. sender_address (needs
channel email) is the From of the email the link goes in: a campaign
email then links to cal.<sending domain>, else to the spare link pool. Email and LinkedIn links never
use a Kenso domain. availability (single_use only) gives the link its own open times instead of the
meeting type's and the host's: {"timeZone": "Europe/Amsterdam" or null for the host's zone,
"weekly": {"monday": [{"start": "09:00", "end": "12:00"}, ...], ..., "sunday": []},
"overrides": [{"date": "2026-12-24", "ranges": []}]}. Times are HH:mm at any whole minute, end up to
24:00, at most 6 ranges a day; a left-out weekday has no times and an override with no ranges blocks
that date (at most 100). Busy time, notice, window, buffers and the daily cap still apply. A refused
schedule names each field, such as availability.weekly.monday[0].end. Returns
{id, url, kind, expiresAt, availability}: 201 when a link was made, 200 when the person's link already
existed. id is what scheduler(operation="links-update", ...) takes to change a single-use link's times.
409 invalid_state when no Scheduler domain can serve the link yet or the meeting type is off.

booking-defaults-get

Read. GET https://api.ken.so/v1/booking-defaults

Read the workspace's Scheduler defaults, including what happens when a meeting falls through.

GET /api/v1/booking-defaults. Internal. Sends Ken-Version 1.1. Needs the scheduler feature and
Calendar view. client_id is sent as X-Ken-Workspace-Id.

Returns {data: {workspaceSlug, workspaceSlugEnabled, lengthMinutes, locationKind, locationDetail,
minimumNoticeMinutes, bookingWindowDays, bufferBeforeMinutes, bufferAfterMinutes, dailyCap,
reminderEnabled, reminderText, questions, accentColor, pageTheme, updatedAt, rebookChaseEnabled,
rebookFirstNudgeBusinessDays, rebookSecondNudgeBusinessDays}}. pageTheme is the booking page's color
scheme: light (the default), dark, or system to follow the visitor's device. rebookChaseEnabled false stops the
rebook-and-chase workflow from starting for a new cancel or no-show; the two timings are business
days from the rebook email to each nudge (true, 2 and 5 until an admin changes them). They act only
where the meeting_rebook_chase feature is on.

bookings-get

Read. GET https://api.ken.so/v1/bookings/{bookingId}

Path: bookingId

One booking: the booker, answers, host, time, attribution and routing reason.

GET /api/v1/bookings/{booking_id}. Public. Sends Ken-Version 1.1. Needs the scheduler feature
and the Calendar page (view). client_id is sent as X-Ken-Workspace-Id. 404 for a booking in
another workspace or one you cannot see (visible like meetings). Same fields as one item of
scheduler(operation="bookings-list", ...).

external-bookings-get

Read. GET https://api.ken.so/v1/external-bookings/{externalBookingId}

Path: externalBookingId

One booking made through a member's Cal.com, Calendly, HubSpot or Chili Piper page.

GET /api/v1/external-bookings/{external_booking_id}. Public. Sends Ken-Version 1.1. Needs the
meetings feature and the Calendar page (view). client_id is sent as X-Ken-Workspace-Id. 404 for
a booking in another workspace or one you cannot see (visible like meetings). Same fields as
one item of scheduler(operation="external-bookings-list", ...).

Read. GET https://api.ken.so/v1/booking-links

Query: cursor string, limit integer

List your open single-use Scheduler links, newest first.

GET /api/v1/booking-links. Public. Sends Ken-Version 1.1. Needs the scheduler feature and the
Calendar page (view). client_id is sent as X-Ken-Workspace-Id.

The single-use links you made in this workspace that can still book: not used, not expired, and
their meeting type not deleted. A team type's link belongs to the member who made it, so admins
see only their own too. Each item is {id, kind, meetingTypeId, personId, createdAt, expiresAt,
availability} (availability null when the link uses its meeting type's times). There is no url:
only a hash of the token is stored, so a link's url is shown once, by
scheduler(operation="links-create", ...). Pass pagination.nextCursor back unchanged; limit is 1..200.

bookings-list

Read. GET https://api.ken.so/v1/bookings

Query: accountId integer, campaignId integer, cursor string, hostMemberId integer, limit integer, organizerMemberId integer, personId integer, startAfter date-time, startBefore date-time, status string

List bookings made through members' Scheduler pages, earliest start first.

GET /api/v1/bookings. Public. Sends Ken-Version 1.1. Needs the scheduler feature and the
Calendar page (view). client_id is sent as X-Ken-Workspace-Id.

Visible like meetings: bookings you host or organize, and bookings with an account (only
accounts you own under account scope own). status (comma = OR): confirmed, rescheduled,
cancelled, no_show. start_after (inclusive) and start_before (exclusive) are ISO-8601 instants
on the start. host_member_id, organizer_member_id, campaign_id, person_id and account_id
filter by id; each narrows the bookings you see and never adds one you cannot see. Pass
pagination.nextCursor back unchanged as cursor; limit 1 to 200 (default 50).

Returns {data: [{id, status, meetingTypeId, hostMemberId, organizerMemberId, startAt, endAt,
bookerTimeZone, booker{name, email, company}, bookerPhone, answers, personId, accountId,
meetingId, source, campaignId, stepOrder, touchId, assetId, bookingLinkId, routingReason,
provider, calendarEmail, cancelReason, cancelledAt, rescheduledFromBookingId, createdAt,
updatedAt}], pagination}. answers maps a question id to its answer: a string, or a list of
strings for a multiple_choice question. routingReason says why the page picked the host.
stepOrder is the step of the latest delivered campaign send before the booking; touchId is
null for now (no account touch is recorded as sent yet).

external-bookings-list

Read. GET https://api.ken.so/v1/external-bookings

Query: accountId integer, campaignId integer, cursor string, limit integer, personId integer, provider string, startAfter date-time, startBefore date-time, status string

List bookings prospects made through members' Cal.com, Calendly, HubSpot or Chili Piper pages.

GET /api/v1/external-bookings. Public. Sends Ken-Version 1.1. Needs the meetings feature and
the Calendar page (view). client_id is sent as X-Ken-Workspace-Id. Read-only: Kenso never owns
these bookings, so there is no no-show, cancel or reassign for them. Kenso's own Scheduler
bookings are scheduler(operation="bookings-list", ...).

Only bookings Kenso matched to the workspace are stored: the invitee is a contact in a live
campaign or a person on an account, or the link carried a Kenso token. Visible like meetings:
bookings you host, and bookings with an account (only accounts you own under account scope
own). provider (comma = OR): cal_com, calendly, hubspot, chili_piper. status (comma = OR):
booked, rescheduled, cancelled, no_show. campaign_id is the credited campaign; account_id and
person_id filter by id. start_after (inclusive) and start_before (exclusive) are ISO-8601
instants on the start. Every filter narrows the bookings you see and never adds one you cannot
see. Earliest start first. Pass pagination.nextCursor back unchanged as cursor; limit 1 to 200
(default 50).

Returns {data: [{id, provider, status, hostMemberId, startAt, endAt, invitee{name, email},
contactId, personId, accountId, campaignId, stepOrder, attribution, meetingId, cancelledAt,
cancelReason, noShowAt, createdAt, updatedAt}], pagination}. attribution says how the campaign
credit was decided: token (the link carried a Kenso token, so campaign and step are exact),
last_touch (the campaign of the invitee's last Kenso send in the last 60 days) or none.
meetingId is the row id of the meeting the booking wrote: meetings(operation="get", ...) reads
it as meeting_id "mtg_" + meetingId.

meeting-types-list

Read. GET https://api.ken.so/v1/meeting-types

Query: cursor string, hostMemberId integer, kind string, limit integer, ownerMemberId integer

List meeting types: every member's bookable types in the workspace, oldest first.

GET /api/v1/meeting-types. Sends Ken-Version 1.1. Needs the scheduler feature and the
Calendar page. owner_member_id narrows to one member. Each item has id, kind (personal,
round_robin, collective), ownerMemberId, name, slug, lengthMinutes, locationKind,
locationDetail, notice, window, buffers, dailyCap, reminder, isSecret, isEnabled, isDefault and questions
(id, label, kind, required; dropdown, single_choice and multiple_choice questions
also carry options, their labels in order).
locationKind is video (the host calendar's own Meet or Teams link, or the fixed link in locationDetail),
google_meet, microsoft_teams, zoom or webex (that conference; a host calendar that cannot make it adds
its own link, and zoom and webex do so until bookings make those meetings), phone, in_person or custom.
kind filters by personal, round_robin or collective (comma = OR); host_member_id lists the types a member
hosts. Team types also carry hosts (memberId, displayName, position, status, isOrganizer) and hostsNote.
Pass pagination.nextCursor back unchanged; limit is 1..200.

bookings-no-show

Write. POST https://api.ken.so/v1/bookings/{bookingId}/no-show

Path: bookingId

Mark a booking as a no-show: logs it on the meeting and puts a "Sorry we missed you" draft in Today.

POST /api/v1/bookings/{booking_id}/no-show. Public. Sends Ken-Version 1.1. Needs the scheduler
feature and the Calendar page (view). client_id is sent as X-Ken-Workspace-Id.

Only the booking's host, its organizer or a workspace admin who can see the booking (as in
bookings-get) may mark it; anyone else gets 404, as for an unknown booking. It can be marked
only once the meeting has started (409 invalid_state before the start or for a cancelled or
rescheduled booking). Marking it again changes nothing. The draft carries a fresh single-use
Scheduler link and waits in Today for a person to approve it; nothing is sent. The account stage
and the sequence do not change.

Returns {data: {id, status: "no_show", ...}} (the bookings-get shape).

meeting-types-slots

Read. GET https://api.ken.so/v1/meeting-types/{meetingTypeId}/slots

Path: meetingTypeId

Query: from date-time, timeZone string, to date-time

Open times on a meeting type: the starts a booker could pick on its owner's page.

GET /api/v1/meeting-types/{meeting_type_id}/slots. Public. Sends Ken-Version 1.1. Needs the
scheduler feature and the Calendar page (view). client_id is sent as X-Ken-Workspace-Id.

from_time and to_time are ISO-8601 instants (to after from, at most 31 days); a slot belongs to
the range by its start. time_zone (IANA) labels each slot's localStartAt (default: the host's zone).
Times are the owner's working hours minus busy time and their gap, then the type's length,
buffers, minimum notice, booking window and daily cap, minus Kenso's confirmed bookings, starting
on the quarter hour.

Returns {meetingTypeId, hostMemberId, lengthMinutes, status, reason, timeZone, hostTimeZone,
slots[{startAt, endAt, localStartAt}]}. status is available, no_availability or unavailable
(reason host_not_member, calendar_not_connected, calendar_needs_reconnect,
calendar_provider_error or meeting_type_disabled). A team type answers hostMemberId null. 404 for a
type not in the workspace. Slots overlap: each is one possible start.

Read. GET https://api.ken.so/v1/booking-links/suggested-times

Query: campaignId integer, hostMemberId integer, meetingTypeId integer, personId integer, senderAddress string

Suggest up to three open times on a person's own Scheduler link, for a one-to-one email.

GET /api/v1/booking-links/suggested-times. Public. Sends Ken-Version 1.1. Needs the scheduler
feature and the Calendar page (view). client_id is sent as X-Ken-Workspace-Id.

The page is host_member_id's (default: you; another member's needs member management) and
meeting_type_id one of that member's own types (default: their default type). The times come
from the member the page routes the person to (their account owner first), at most one per day
over 14 days. Each time's url opens the Scheduler page with that time picked. A member who books
through Calendly, Cal.com or HubSpot gets status external_tool and that link, with no times.
campaign_id is the campaign of the thread being answered (404 when it is not this workspace's):
a booking through the link then counts for that campaign. sender_address is the mailbox the reply
goes out from (400 when it is not an email address): with campaign_id, the link lands on
cal.<sending domain> when that host is ready, else on the spare link pool.

Returns {data: {status (available, no_availability, unavailable, external_tool), reason,
bookingTool, hostMemberId, meetingTypeId, routingReason, timeZone, url,
times: [{startAt, endAt, localStartAt, url}]}}.

booking-defaults-update

Write. PATCH https://api.ken.so/v1/booking-defaults

Body (json): accentColor string, bookingWindowDays integer, bufferAfterMinutes integer, bufferBeforeMinutes integer, dailyCap integer, lengthMinutes integer, locationDetail string, locationKind string, minimumNoticeMinutes integer, pageTheme string, questions array, rebookChaseEnabled boolean, rebookFirstNudgeBusinessDays integer, rebookSecondNudgeBusinessDays integer, reminderEnabled boolean, reminderText string, workspaceSlug string, workspaceSlugEnabled boolean

Turn the rebook-and-chase workflow on or off, change its two nudge timings, or set the page theme.

PATCH /api/v1/booking-defaults. Internal. Sends Ken-Version 1.1. Needs the scheduler feature, the
Calendar page and the members feature (admins), and never a client seat. client_id is sent as
X-Ken-Workspace-Id.

Send at least one field; the ones you leave out stay. rebook_chase_enabled false stops the
rebook-and-chase workflow from starting for a new cancel or no-show (a flow already running keeps
going). rebook_first_nudge_business_days (1 to 29) and rebook_second_nudge_business_days (more than
the first, at most 30) are business days from the rebook email to each nudge; one sent alone is
checked against the stored other (400 validation_failed, out_of_range). A change applies to the next
flow. They act only where the meeting_rebook_chase feature is on. page_theme is the booking page's
color scheme for the whole workspace: light, dark, or system to follow the visitor's device. The
other Scheduler defaults (length, location, notice, questions, accent) are changed in Settings >
Scheduler.

Returns the defaults as booking-defaults-get does.

Write. PATCH https://api.ken.so/v1/booking-links/{bookingLinkId}

Path: bookingLinkId

Body (json): availability object

Change the open times of one of your single-use Scheduler links after it was made.

PATCH /api/v1/booking-links/{booking_link_id}. Public. Sends Ken-Version 1.1. Needs the scheduler
feature and the Calendar page (view), and never a client seat (403 permission_denied whatever its
template grants). client_id is sent as X-Ken-Workspace-Id.

booking_link_id is the id scheduler(operation="links-create", ...) or
scheduler(operation="links-list", ...) returned. availability replaces the link's whole schedule,
in the links-create shape: {"timeZone": "Europe/Amsterdam" or null for the host's zone,
"weekly": {"monday": [{"start": "09:00", "end": "12:00"}], ...}, "overrides": [{"date":
"2026-12-24", "ranges": [{"start": "13:00", "end": "15:00"}]}]}. Only specific dates: send
overrides with ranges and no weekly times. "" clears it, so the link uses its meeting type's
times again. Only the member who made the link changes it: another member's link, a person link
and a link in another workspace are 404. A used or expired link is 409 invalid_state (link_used,
link_expired). A refused schedule names each field, such as availability.weekly.monday[0].end.
Returns {data} in the links-list item shape.