Skip to main content
Glama
YouCanBookMe MCP Server

YouCanBookMe MCP Server

by OfirOhan

YouCanBookMe MCP Server

CI MCP License: MIT

A Model Context Protocol server for YouCanBookMe. It lets Claude, Cursor, ChatGPT and other AI agents find open times on your booking pages, book, reschedule and cancel bookings, and answer questions like "how many no-shows did we have last month?".

Unofficial. This is a community project and is not affiliated with YouCanBookMe or Capacity. It was built from YouCanBookMe's public API docs.

What you can ask your agent

  • "What's on my Demo booking page for the next 3 days, and who are the bookers?"

  • "Find two morning slots on acme-demo next week in New York time and draft an email offering them to Sam."

  • "Book Dana Levi (dana@acme.com, London) into the first Tuesday slot."

  • "Move booking ref QNBZAQPTAITT to Thursday at 2pm."

  • "How many bookings, cancellations and no-shows did each booking page get in September?"

  • "Find every booking made by someone at acme.com this quarter."

Related MCP server: Cal.com MCP Server for Customers

Tools

Tool

What it does

Writes?

list_booking_pages

All booking pages (profiles) with id, title and subdomain

No

get_booking_page

One page's settings (choose fields with dot notation)

No

list_upcoming_bookings

Upcoming bookings for the next N days, with booker name and email

No

search_bookings

Bookings in a time range by status, page, or text (name, email, ref)

No

get_booking

One booking with times, status and form answers

No

booking_report

Counts by status (finished, cancelled, noShow...) and by page for a period

No

find_available_times

Open slots, grouped by day with local times, returns an intentId

Starts an intent

book_time

Book a slot found above (creates a real booking)

Yes

reschedule_booking

Move a booking to a new start time

Yes

cancel_booking

Cancel as the calendar owner (removes the calendar event)

Destructive

delete_booking

Permanently delete a booking record

Destructive

YouCanBookMe's booking API is built on booking intents (create intent, set selections, read availability, confirm). This server hides that flow behind two tools. find_available_times returns readable slots plus an intentId, and book_time fills in the form and confirms. Availability comes back as unix-millisecond timestamps, so the server converts it to ISO times and local clock times an LLM can reason about. Write tools carry MCP annotations, so clients can ask before running them.

Setup

  1. In YouCanBookMe, open Account > Password & Security (link) and copy your Account ID and API key (starts with ak_). On a Team plan, use the Organization Owner's key.

  2. Build it:

git clone https://github.com/OfirOhan/youcanbookme-mcp.git
cd youcanbookme-mcp && npm install && npm run build

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "youcanbookme": {
      "command": "node",
      "args": ["/absolute/path/to/youcanbookme-mcp/dist/index.js"],
      "env": { "YCBM_ACCOUNT_ID": "your-account-id", "YCBM_API_KEY": "ak_..." }
    }
  }
}

Claude Code / Cursor / other MCP clients

claude mcp add youcanbookme -e YCBM_ACCOUNT_ID=... -e YCBM_API_KEY=ak_... -- node /path/to/youcanbookme-mcp/dist/index.js

For Cursor and other clients, use the same command with the variables in the environment.

Variable

Default

Notes

YCBM_ACCOUNT_ID

(required)

Your account ID (HTTP basic auth username)

YCBM_API_KEY

(required)

Your API key (HTTP basic auth password)

YCBM_BASE_URL

https://api.youcanbook.me

Override for testing

Development

npm install
npm test   # builds, runs unit tests and an end-to-end MCP stdio test against a fake YouCanBookMe API

The tests run on Node 20, 22 and 24 in CI.

Author

Built by Ofir Ohana, an AI agents engineer. Issues and PRs are welcome.

License

MIT

Available Tools

11 tools
booking_reportBooking reportA
Read-only

Counts of bookings in a period by status (finished, cancelled, noShow, upcoming...) and by booking page. Good for 'how many no-shows did we have last month?'.

Inputs: to (required), from (required), bookingPageIds.

book_timeBook a timeA

Book a slot found by find_available_times. Fills the booking form and confirms the intent, which creates a real booking and calendar event and sends notifications, so confirm details with the user first.

Inputs: email (required), intentId (required), startsAt (required), timeZone (required), +4 more.

cancel_bookingCancel bookingA
DestructiveIdempotent

Cancel a booking as the calendar owner. The calendar event is removed and cancellation notifications are sent per the page's settings. Confirm with the user first.

Inputs: bookingId (required).

delete_bookingDelete bookingA
DestructiveIdempotent

Permanently delete a booking record from YouCanBookMe. No further notifications are sent, but the calendar event stays on the calendar. Prefer cancel_booking unless the user explicitly wants the record gone.

Inputs: bookingId (required).

find_available_timesFind available timesA

Find open times on a booking page, grouped by day with readable local times. This starts a booking intent and returns its intentId. Pass that intentId and one slot's exact startsAt to book_time to book it.

Inputs: timeZone (required), subdomain (required), from, until, +3 more.

get_bookingGet bookingA
Read-only

Get one booking with times, status, booking page, and the booker's form answers.

Inputs: bookingId (required), fields.

get_booking_pageGet booking pageB
Read-only

Get one booking page's settings. Use fields to ask for specific nested settings (dot notation).

Inputs: profileId (required), fields.

list_booking_pagesList booking pagesA
Read-only

List the account's booking pages (the API calls them profiles). Returns each page's id, title and subdomain. The subdomain is what find_available_times needs.

Inputs: fields.

list_upcoming_bookingsList upcoming bookingsA
Read-only

List upcoming (not cancelled) bookings for the next N days, soonest first, with booker name and email.

Inputs: days, bookingPageIds.

reschedule_bookingReschedule bookingA
Idempotent

Move a booking to a new start time. Use find_available_times first to pick a free slot. The booker is notified, so confirm with the user first.

Inputs: bookingId (required), newStartsAt (required).

search_bookingsSearch bookingsA
Read-only

Search bookings in a time range, optionally by status, booking page, or text (booker name/email in the form, title, or booking ref). Returns counts by status and page plus a compact list with booker name and email. Set raw=true for YCBM's full objects.

Inputs: from (required), to, raw, pageSize, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools target clearly distinct operations (get_booking vs get_booking_page, cancel_booking vs delete_booking, find_available_times vs book_time). The main overlap is between search_bookings, list_upcoming_bookings, and booking_report, all of which return booking information, but their descriptions clarify different use cases well enough.

    Naming Consistency4/5

    The set is mostly consistent snake_case with a verb_noun pattern (get_booking, cancel_booking, list_booking_pages, find_available_times). Minor deviations like booking_report (noun_noun) and book_time (verb_noun but less explicit) are readable but slightly break the pattern.

    Tool Count5/5

    Eleven tools is well-scoped for a booking management server. Each tool covers a distinct part of the booking workflow—discovery, availability, booking, modification, cancellation, deletion, and reporting—without obvious redundancy.

    Completeness4/5

    The server covers the full booking lifecycle for existing pages: list/get pages, search/get bookings, check availability, book, reschedule, cancel, delete, and report. It lacks booking page creation/update settings and possibly booking note/comment operations, but core agent workflows are well supported.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers