Bookeo MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.2Updated Nov 14, 2026

Check Bookeo availability and manage bookings, holds and customers; read payments.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Hosted Bookeo server that lets an assistant check availability, create holds and bookings, update or cancel bookings, and manage customers and payments.

What you can do
  • Inspect account setup: API key permissions, business details, products, people categories and resources
  • Check availability: list slots for fixed products and search matching slots for a party, with estimated price
  • Manage bookings: list, get, create, reschedule or update, and cancel bookings, and list a booking's payments
  • Manage customers: search and list customers, get one customer's history, create and update contact details
  • Read payments: list payments for a period or by method, and get a single payment with gateway transaction id
  • Check usage and manage the subscription plan
When to use it
Useful when you run a Bookeo account for tours, classes, courses or appointments and want to ask questions in plain language about open seats, upcoming bookings, customer history or payments, or have the assistant draft and place bookings.
Requirements
Remote MCP endpoint, no local install. Sign-in is via OAuth; the login page asks for a Bookeo API key and secret key from a Bookeo developer app authorized for your account (Bookeo paid plan). Add only the URL to the client config, with no Authorization header or API key.
Before you install
The server receives your Bookeo API key and secret key and stores them per user. Write tools create, change or cancel bookings and customers, and cancellation does not apply the account's cancellation policy, so no cancellation fee is charged. Bookings created do not record payment. Free plan is limited to 50 calls per month; paid plans are billed through a Stripe checkout link and plan changes charge a prorated difference with no refund on cancellation.

Installation

In SourceWeft

  1. Open Bookeo MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fbookeo/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "bookeo-by-usefulapi": {
      "type": "http",
      "url": "https://bookeo.usefulapi.io/mcp"
    }
  }
}

README

Bookeo MCP by usefulapi

Use Bookeo from Claude, Cursor, or any MCP client — check availability, create holds and bookings, update or cancel bookings, and manage customers. Hosted, no local install: connect with your own Bookeo credentials.

Live endpoint: https://bookeo.usefulapi.io/mcp · Homepage: https://usefulapi.io/bookeo

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://bookeo.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http bookeo https://bookeo.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "bookeo": {      "url": "https://bookeo.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Bookeo credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bookeo/

On first connect you'll provide your Bookeo API key and secret key (a Bookeo developer app authorized for your account; paid plan). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
bookeo_get_api_key_inforeadGet API key info
bookeo_get_businessreadGet the business
bookeo_list_productsreadList products
bookeo_list_people_categoriesreadList people categories
bookeo_list_resourcesreadList resources
bookeo_get_availability_slotsreadGet availability slots
bookeo_search_matching_slotsreadSearch matching slots
bookeo_list_bookingsreadList bookings
bookeo_get_bookingreadGet a booking
bookeo_list_booking_paymentsreadList a booking's payments
bookeo_list_customersreadList customers
bookeo_get_customerreadGet a customer
bookeo_list_customer_bookingsreadList a customer's bookings
bookeo_list_paymentsreadList payments
bookeo_get_paymentreadGet a payment
bookeo_create_holdwriteHold seats (price check)
bookeo_create_bookingwriteCreate a booking
bookeo_update_bookingwriteUpdate a booking
bookeo_cancel_bookingwriteCancel a booking
bookeo_create_customerwriteCreate a customer
bookeo_update_customerwriteUpdate a customer
bookeo_usage_statusmetaUsage status (free-tier meter)
bookeo_request_featuremetaRequest a missing feature
bookeo_upgrademetaUpgrade to Pro or Pro+
bookeo_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run bookeo_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with bookeo_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with bookeo_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Bookeo.

Source: servers/bookeo/README.md at commit 3c1b3df

Tools

21

bookeo_get_api_key_info

Get API key info

Show which Bookeo account the credentials belong to and which permissions were granted (e.g. bookings_rw_all, customers_r_all, availability_r). A cheap way to confirm the setup works. Bookeo: GET /settings/apikeyinfo.

Takes no parameters.

bookeo_get_business

Get the business

Get the business's name, contact details, address, website and description. Bookeo: GET /settings/business.

Takes no parameters.

bookeo_list_products

List products

List the bookable products (tours, classes, courses, appointments) with their ids, type (fixed, fixedCourse, flexibleTime), duration, participant limits per people category, default rates and options. Bookeo: GET /settings/products.

ParameterslangtypepageNumberitemsPerPagepageNavigationToken

bookeo_list_people_categories

List people categories

List the participant categories the account uses (default Adults/Children/Infants plus custom ones like Students), with their ids and seats taken. Needed for peopleNumbers. Bookeo: GET /settings/peoplecategories.

Takes no parameters.

bookeo_list_resources

List resources

List resource types and their resources (guides, instructors, rooms, boats...) with ids. Bookeo: GET /settings/resources.

ParameterspageNumberitemsPerPagepageNavigationToken

bookeo_get_availability_slots

Get availability slots

List available slots (eventId, start/end, seats available) for fixed and fixedCourse products in a time window of at most 31 days. Not for flexibleTime products — use bookeo_search_matching_slots for those. Bookeo: GET /availability/slots.

ParametersmodeendTimeproductIdstartTimepageNumberitemsPerPagepageNavigationToken

bookeo_search_matching_slots

Search matching slots

Find slots that can take a given party (participant counts per category, options, resources), with an estimated price. Works for all product types, including flexibleTime appointments. Window max 31 days. To page through results pass only pageNavigationToken (+ pageNumber). Read-only. Bookeo: POST /availability/matchingslots, GET /availability/matchingslots/{pageNavigationToken}.

ParametersmodeendTimeoptionsproductIdresourcesstartTimepageNumberitemsPerPagepeopleNumberspageNavigationToken

bookeo_list_bookings

List bookings

List bookings by start time (startTime+endTime) and/or by last change (lastUpdatedStartTime+lastUpdatedEndTime) — at least one pair is required, each spanning at most 31 days. Optionally filter by product, include canceled bookings, and expand customer/participant details. Bookeo: GET /bookings.

ParametersendTimeproductIdstartTimepageNumberitemsPerPageexpandCustomerincludeCanceledexpandParticipantslastUpdatedEndTimepageNavigationTokenlastUpdatedStartTime

bookeo_get_booking

Get a booking

Get one booking by its booking number: product, times, participants, options, price, paid amount, status (canceled/accepted/noShow). Bookeo: GET /bookings/{bookingNumber}.

ParametersbookingNumberrequiredexpandCustomerexpandParticipants

bookeo_list_booking_payments

List a booking's payments

List the payments (and refunds, as negative amounts) received for one booking. Bookeo: GET /bookings/{bookingNumber}/payments.

ParameterspageNumberitemsPerPagebookingNumberrequiredpageNavigationToken

bookeo_list_customers

List customers

List or search customers — by name, firstName, lastName or emailAddress — optionally only members/non-members or those created since a date. Bookeo: GET /customers.

ParameterspageNumbersearchTextsearchFieldcreatedSinceitemsPerPagecurrentMemberscurrentNonMemberspageNavigationToken

bookeo_get_customer

Get a customer

Get one customer: contact details, next/previous booking, number of bookings, cancellations and no-shows, membership and store credit. Bookeo: GET /customers/{id}.

Parametersidrequired

bookeo_list_customer_bookings

List a customer's bookings

List one customer's bookings, optionally between two dates. Bookeo: GET /customers/{id}/bookings.

ParametersidrequiredendDatebeginDatepageNumberitemsPerPageexpandParticipantspageNavigationToken

bookeo_list_payments

List payments

List payments received in a time period, optionally by payment method. Refunds are included with a negative amount. Bookeo: GET /payments.

ParametersendTimestartTimepageNumberitemsPerPagepaymentMethodpaymentMethodOtherpageNavigationToken

bookeo_get_payment

Get a payment

Get one payment: amount, method, reason, received time, customer and gateway transaction id. Bookeo: GET /payments/{id}.

Parametersidrequired

bookeo_create_hold

Hold seats (price check)

Temporarily reserve the seats/resources for a draft booking (default 300 s, max 600 s) and get the FINAL price, taxes and amount payable. The recommended step before bookeo_create_booking: pass the returned hold id as previousHoldId there. Holds expire automatically. Bookeo: POST /holds.

ParametersendTimeeventIdoptionscustomerproductIdrequiredresourcesstartTimecustomerIdexternalRefprivateEventpeopleNumbersrequiredpreviousHoldId+2 more

bookeo_create_booking

Create a booking

Create a confirmed booking for an existing customer (customerId) or a new one (customer). fixed/fixedCourse products need an eventId from the availability tools; flexibleTime products take eventId or startTime. Pass previousHoldId to convert a hold. Does NOT record any payment. Reversible with bookeo_cancel_booking. Bookeo: POST /bookings.

ParametersmodeendTimeeventIdoptionscustomerproductIdrequiredresourcesstartTimecustomerIdexternalRefnotifyUsersprivateEvent+6 more

bookeo_update_booking

Update a booking

Change an existing booking — reschedule (eventId or startTime/endTime), change participant counts, options, resources or external reference. Fetches the current booking and sends it back with only your changes applied (Bookeo's PUT takes the full booking). Bookeo: GET then PUT /bookings/{bookingNumber}.

ParametersmodeendTimeeventIdoptionsresourcesstartTimeexternalRefnotifyUsersbookingNumberrequiredpeopleNumbersnotifyCustomerpromotionCodeInput

bookeo_cancel_booking

Cancel a booking

Cancel a booking. It stays in the system (visible with includeCanceled) but frees its seats. The account's cancellation policy is NOT applied, so no cancellation fee is charged. Bookeo: DELETE /bookings/{bookingNumber}.

ParametersreasonnotifyUsersbookingNumberrequirednotifyCustomercancelRemainingSeriestrackInCustomerHistory

bookeo_create_customer

Create a customer

Create a customer record. Not needed before booking — bookeo_create_booking can create the customer inline. Bookeo: POST /customers.

ParametersgenderlastNamerequiredfirstNamerequiredmiddleNamedateOfBirthemailAddresslanguageCodephoneNumbersstreetAddressacceptSmsReminders

bookeo_update_customer

Update a customer

Update a customer's contact details. Fetches the current record and sends it back with only your changes applied (Bookeo's PUT takes the full customer). Bookeo: GET then PUT /customers/{id}.

ParametersidrequiredgenderlastNamefirstNamemiddleNamedateOfBirthemailAddresslanguageCodephoneNumbersstreetAddressacceptSmsReminders

Version history

26
  1. v1.39.2LatestNov 14, 2026
  2. v1.39.1Nov 13, 2026
  3. v1.38.0Nov 12, 2026
  4. v1.37.3Nov 11, 2026
  5. v1.36.5Nov 8, 2026
  6. v1.36.4Nov 7, 2026
  7. v1.35.3Nov 5, 2026
  8. v1.35.2Nov 5, 2026
  9. v1.35.1Nov 4, 2026
  10. v1.35.0Nov 3, 2026
  11. v1.34.1Nov 3, 2026
  12. v1.33.0Nov 1, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.0Oct 31, 2026
  15. v1.29.2Oct 30, 2026
  16. v1.29.0Oct 30, 2026
  17. v1.24.0Oct 26, 2026
  18. v1.21.3Oct 25, 2026
  19. v1.21.0Oct 25, 2026
  20. v1.20.0Oct 24, 2026
  21. v1.17.0Oct 23, 2026
  22. v1.16.4Oct 22, 2026
  23. v1.16.3Oct 21, 2026
  24. v1.11.1Oct 9, 2026
  25. v1.10.0Oct 9, 2026
  26. v1.0.0Sep 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations