Bookeo MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.39.2更新于 Nov 14, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

托管的 Bookeo 服务器,让助手查询可预约时段、创建占位与预订、修改或取消预订,并管理客户与付款。

可以做什么
  • 查看账户配置:API 密钥权限、商家信息、产品、人员类别与资源
  • 查询可预约情况:列出固定产品的时段,并按人数搜索匹配时段及预估价格
  • 管理预订:列出、查看、创建、改期或更新、取消预订,并列出某笔预订的付款
  • 管理客户:搜索和列出客户、查看单个客户的记录、创建和更新联系方式
  • 读取付款:按时间段或支付方式列出付款,并查看单笔付款及网关交易号
  • 查看用量并管理订阅方案
适用场景
适合经营 Bookeo 账户(旅游、课程、培训或预约服务)并希望用自然语言询问空位、近期预订、客户历史或收款情况,或让助手起草并提交预订的场景。
运行要求
远程 MCP 端点,无需本地安装。通过 OAuth 登录,登录页要求提供已在你的账户上授权的 Bookeo 开发者应用所生成的 API 密钥和密钥(需 Bookeo 付费方案)。客户端配置中只填 URL,不要添加 Authorization 头或 API 密钥。
安装前请注意
服务器会接收并按用户保存你的 Bookeo API 密钥和密钥。写入类工具会创建、修改或取消预订和客户;取消预订不会套用账户的取消政策,因此不收取取消费。创建的预订不会记录付款。免费方案每月限 50 次调用;付费方案通过 Stripe 结账链接计费,变更方案会按比例立即收取差价,取消时不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Bookeo MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fbookeo/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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.

来源:servers/bookeo/README.md,提交 3c1b3df

工具

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.

无需输入参数。

bookeo_get_business

Get the business

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

无需输入参数。

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.

输入参数langtypepageNumberitemsPerPagepageNavigationToken

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.

无需输入参数。

bookeo_list_resources

List resources

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

输入参数pageNumberitemsPerPagepageNavigationToken

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.

输入参数modeendTimeproductIdstartTimepageNumberitemsPerPagepageNavigationToken

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}.

输入参数modeendTimeoptionsproductIdresourcesstartTimepageNumberitemsPerPagepeopleNumberspageNavigationToken

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.

输入参数endTimeproductIdstartTimepageNumberitemsPerPageexpandCustomerincludeCanceledexpandParticipantslastUpdatedEndTimepageNavigationTokenlastUpdatedStartTime

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}.

输入参数bookingNumber必填expandCustomerexpandParticipants

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.

输入参数pageNumberitemsPerPagebookingNumber必填pageNavigationToken

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.

输入参数pageNumbersearchTextsearchFieldcreatedSinceitemsPerPagecurrentMemberscurrentNonMemberspageNavigationToken

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}.

输入参数id必填

bookeo_list_customer_bookings

List a customer's bookings

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

输入参数id必填endDatebeginDatepageNumberitemsPerPageexpandParticipantspageNavigationToken

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.

输入参数endTimestartTimepageNumberitemsPerPagepaymentMethodpaymentMethodOtherpageNavigationToken

bookeo_get_payment

Get a payment

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

输入参数id必填

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.

输入参数endTimeeventIdoptionscustomerproductId必填resourcesstartTimecustomerIdexternalRefprivateEventpeopleNumbers必填previousHoldId另有 2 个

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.

输入参数modeendTimeeventIdoptionscustomerproductId必填resourcesstartTimecustomerIdexternalRefnotifyUsersprivateEvent另有 6 个

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}.

输入参数modeendTimeeventIdoptionsresourcesstartTimeexternalRefnotifyUsersbookingNumber必填peopleNumbersnotifyCustomerpromotionCodeInput

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}.

输入参数reasonnotifyUsersbookingNumber必填notifyCustomercancelRemainingSeriestrackInCustomerHistory

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.

输入参数genderlastName必填firstName必填middleNamedateOfBirthemailAddresslanguageCodephoneNumbersstreetAddressacceptSmsReminders

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}.

输入参数id必填genderlastNamefirstNamemiddleNamedateOfBirthemailAddresslanguageCodephoneNumbersstreetAddressacceptSmsReminders

版本历史

26
  1. v1.39.2最新Nov 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

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成