YouCanBookMe MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@YouCanBookMe MCP Server find open morning slots on acme-demo next week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
YouCanBookMe MCP Server
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? |
| All booking pages (profiles) with id, title and subdomain | No |
| One page's settings (choose fields with dot notation) | No |
| Upcoming bookings for the next N days, with booker name and email | No |
| Bookings in a time range by status, page, or text (name, email, ref) | No |
| One booking with times, status and form answers | No |
| Counts by status (finished, cancelled, noShow...) and by page for a period | No |
| Open slots, grouped by day with local times, returns an | Starts an intent |
| Book a slot found above (creates a real booking) | Yes |
| Move a booking to a new start time | Yes |
| Cancel as the calendar owner (removes the calendar event) | Destructive |
| 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
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.Build it:
git clone https://github.com/OfirOhan/youcanbookme-mcp.git
cd youcanbookme-mcp && npm install && npm run buildClaude 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.jsFor Cursor and other clients, use the same command with the variables in the environment.
Variable | Default | Notes |
| (required) | Your account ID (HTTP basic auth username) |
| (required) | Your API key (HTTP basic auth password) |
|
| Override for testing |
Development
npm install
npm test # builds, runs unit tests and an end-to-end MCP stdio test against a fake YouCanBookMe APIThe 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 toolsbooking_reportBooking reportARead-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 bookingADestructiveIdempotent
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 bookingADestructiveIdempotent
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 bookingARead-only
Get one booking with times, status, booking page, and the booker's form answers.
Inputs: bookingId (required), fields.
get_booking_pageGet booking pageBRead-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 pagesARead-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 bookingsARead-only
List upcoming (not cancelled) bookings for the next N days, soonest first, with booker name and email.
Inputs: days, bookingPageIds.
reschedule_bookingReschedule bookingAIdempotent
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 bookingsARead-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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Manage YouCanBook.me bookings, booking pages, appointment types, team members and locations.
Schedule, members, and bookings in your AI tools
AI-native scheduling and booking: check availability, book meetings, share links.
Booking pages for your assistant: find slots, book, reschedule, cancel, time off and leads.
Related MCP Servers
AlicenseAqualityCmaintenanceConnects AI assistants to Cal.com for managing bookings, event types, and availability through natural language.1250 npmMIT- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to book meetings, check availability, and manage Cal.com scheduling through natural conversation.MIT
- AlicenseNot gradedqualityDmaintenanceExposes Cal.com scheduling tools to AI agents via MCP, enabling listing event types, checking availability, and managing bookings (create, cancel, reschedule).67 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to schedule meetings via Astrocal's scheduling API, including checking availability, booking, canceling, rescheduling, and managing waitlists through natural conversation.59 npm1MIT