OpenBooking / Developers / MCP booking server
Open source · TypeScript · Apache-2.0

An MCP booking server AI agents can actually book through

OpenBooking is an open-source MCP server for appointment booking: it gives Claude, ChatGPT and any MCP client six tools to read business info, search availability, hold a slot, confirm, look up and cancel bookings. Holds expire, retries never double-book, and nothing is confirmed without the customer’s explicit consent.

$npx create-openbooking my-salon

How it looks

Run it with one command, then connect /mcp to Claude as a custom connector or to ChatGPT in developer mode.

  • Holds that expire
  • Idempotent retries, no double bookings
  • Explicit consent with user_confirmed
  • Cancellation terms shown before booking
$ npx create-openbooking my-salon && cd my-salon && npm run dev

// MCP endpoint: http://localhost:3000/mcp  (Streamable HTTP)
get_business_info    // services, staff, hours, address, policies
search_availability  // free slots with price and cancellation terms
hold_slot            // reserve a slot for a few minutes
confirm_booking      // needs user_confirmed: true
get_booking
cancel_booking       // applies the cancellation terms
Two-step booking

hold_slot reserves, confirm_booking commits. The agent can show the customer the exact time, price and terms in between.

Idempotent by design

Every mutation takes an idempotency key, so a retried call returns the same booking instead of a second one.

Errors agents can act on

Every error has a code and a suggested next action, and every response carries a next_step.

Questions

Which MCP transport does it use?

Streamable HTTP at /mcp, so it works as a remote connector in Claude, in ChatGPT developer mode, and in MCP clients such as Cursor.

How does it stop an agent booking without asking?

confirm_booking requires user_confirmed: true, and the tool description tells the agent to show the time, price and cancellation terms and get a yes first. The engine rejects confirmations without it.

What happens if the agent retries a call?

Mutations are idempotent: the same idempotency key returns the same result, so a retry after a timeout never creates a second booking.

Is it free?

Yes. OpenBooking is open source under Apache-2.0 and published on npm as @openbooking-sh/*.

More for developers