Wix Bookings MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Wix Bookings: 10 typed functions through one MCP server. No Wix Bookings API key needed.
- Site
- wixapis.com
- Functions
- 10
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Wix Bookings alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/wix_bookingsOne MCP server for Wix Bookings and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
findSiteResolves what a caller has (a Wix business's website URL, a wixsite.com or wix.com/<user>/<site> link, or a booking-page link) to the site's base URL…Arguments
Name Type Required sitestringYes Returns
WixSiteInfointerface WixSiteInfo { baseUrl: string; metaSiteId: string | null; /** Whether the Wix Bookings app is installed on this site. */ bookingsInstalled: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/findSiteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.findSite({ site: "<site>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.findSite({"site": "<site>"}))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/findSite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.findSite({ site: "<site>" });getOpenTimesReturns the open appointment times for a service between two dates, with location, staff and spots left, so a caller can pick one to book.Arguments
Name Type Required sitestringYes serviceIdstringA service id from listServices().services[].id.Yes fromDatestring"YYYY-MM-DD", inclusive.Yes toDatestring"YYYY-MM-DD", exclusive.Yes timeZonestringAn IANA zone, e.g. "America/New_York".No Returns
WixOpenTimesinterface WixOpenSlot { startDate: string; endDate: string; locationId: string | null; locationName: string | null; remainingCapacity: number | null; totalCapacity: number | null; bookable: boolean; } interface WixOpenTimes { serviceId: string; timeZone: string | null; slots: WixOpenSlot[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/getOpenTimesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.getOpenTimes({ site: "<site>", serviceId: "<serviceId>", fromDate: "<fromDate>", toDate: "<toDate>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.getOpenTimes({ "site": "<site>", "serviceId": "<serviceId>", "fromDate": "<fromDate>", "toDate": "<toDate>" }))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/getOpenTimes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>","serviceId":"<serviceId>","fromDate":"<fromDate>","toDate":"<toDate>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.getOpenTimes({ site: "<site>", serviceId: "<serviceId>", fromDate: "<fromDate>", toDate: "<toDate>" });getServiceReturns one service in full: description, price and payment options, duration, staff who perform it, location, booking policy (cancellation window…Arguments
Name Type Required sitestringYes serviceIdstringA service id from listServices().services[].id or searchServices.Yes Returns
WixServiceDetailinterface WixServicePayment { inPerson: boolean; online: boolean; deposit: boolean; pricingPlan: boolean; } interface WixService { id: string; name: string; description: string | null; /** Wix's own kind: "APPOINTMENT", "CLASS" or "COURSE". */ type: string; durationMinutes: number | null; price: string | null; currency: string | null; payment: WixServicePayment; onlineBookingEnabled: boolean; staffMemberIds: string[]; /** The id getOpenTimes resolves to a schedule, present only on an appointment-type service. */ scheduleId: string | null; bookingPageUrl: string | null; /** This same id comes back from listCategories. */ categoryId: string | null; categoryName: string | null; checkout: WixCheckout | null; } interface WixCheckout { status: "ready_to_checkout" | "needs_login" | "unavailable"; /** Always https, on the studio's own site. */ url: string; /** ready_to_checkout only: carries_items opens this very slot, product_page opens the studio's schedule. */ urlKind?: "carries_items" | "signed_in_cart" | "product_page"; /** unavailable only: out_of_stock (class full, no waitlist) or not_available_for_dates (cancelled). */ reason?: string; detail?: string; account: { site: string; hint: string; signedInAs?: string; signInUrl?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string; /** ISO start/end of the class or slot, with the studio's UTC offset when the site gives one. */ dates?: { start: string; end?: string }; } | null; warnings: string[]; } interface WixServiceLocation { id: string; type: string; formattedAddress: string | null; } interface WixBookingPolicy { description: string | null; cancellationAllowed: boolean; latestCancellationMinutes: number | null; rescheduleAllowed: boolean; latestRescheduleMinutes: number | null; latestBookingMinutes: number | null; earliestBookingMinutes: number | null; maxParticipantsPerBooking: number | null; } interface WixServiceDetail extends WixService { locations: WixServiceLocation[]; bookingPolicy: WixBookingPolicy | null; formId: string | null; servicePageUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/getServiceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.getService({ site: "<site>", serviceId: "<serviceId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.getService({"site": "<site>", "serviceId": "<serviceId>"}))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/getService \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>","serviceId":"<serviceId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.getService({ site: "<site>", serviceId: "<serviceId>" });listCategoriesLists the categories a business groups its services into.Arguments
Name Type Required sitestringYes Returns
ListCategoriesResultinterface WixCategory { id: string; name: string; sortOrder: number | null; } interface ListCategoriesResult { categories: WixCategory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.listCategories({ site: "<site>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.listCategories({"site": "<site>"}))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.listCategories({ site: "<site>" });listLocationsLists a business's locations with address, phone, email and time zone.Arguments
Name Type Required sitestringYes Returns
ListLocationsResultinterface WixLocationAddress { formattedAddress: string | null; city: string | null; subdivision: string | null; country: string | null; postalCode: string | null; hint: string | null; } interface WixLocation { id: string; name: string; default: boolean; /** The site's own label, e.g. "ACTIVE", read the value off a result, never guess one from prose. */ status: string; timeZone: string | null; email: string | null; phone: string | null; address: WixLocationAddress | null; } interface ListLocationsResult { locations: WixLocation[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/listLocationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.listLocations({ site: "<site>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.listLocations({"site": "<site>"}))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/listLocations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.listLocations({ site: "<site>" });listServicesLists a Wix business's bookable services: name, description, type (appointment, class or course), price and how it is paid (in person, online…Arguments
Name Type Required sitestringYes limitnumberMax services returned (default 50, max 200).No Returns
WixServiceListinterface WixServicePayment { inPerson: boolean; online: boolean; deposit: boolean; pricingPlan: boolean; } interface WixService { id: string; name: string; description: string | null; /** Wix's own kind: "APPOINTMENT", "CLASS" or "COURSE". */ type: string; durationMinutes: number | null; price: string | null; currency: string | null; payment: WixServicePayment; onlineBookingEnabled: boolean; staffMemberIds: string[]; /** The id getOpenTimes resolves to a schedule, present only on an appointment-type service. */ scheduleId: string | null; bookingPageUrl: string | null; /** This same id comes back from listCategories. */ categoryId: string | null; categoryName: string | null; checkout: WixCheckout | null; } interface WixCheckout { status: "ready_to_checkout" | "needs_login" | "unavailable"; /** Always https, on the studio's own site. */ url: string; /** ready_to_checkout only: carries_items opens this very slot, product_page opens the studio's schedule. */ urlKind?: "carries_items" | "signed_in_cart" | "product_page"; /** unavailable only: out_of_stock (class full, no waitlist) or not_available_for_dates (cancelled). */ reason?: string; detail?: string; account: { site: string; hint: string; signedInAs?: string; signInUrl?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string; /** ISO start/end of the class or slot, with the studio's UTC offset when the site gives one. */ dates?: { start: string; end?: string }; } | null; warnings: string[]; } interface WixServiceList { services: WixService[]; total: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/listServicesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.listServices({ site: "<site>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.listServices({"site": "<site>"}))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/listServices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.listServices({ site: "<site>" });listStaffLists the staff a customer can book with at a business, with name, photo and the services they perform.Arguments
Name Type Required sitestringYes Returns
ListStaffResultinterface WixStaffMember { id: string; name: string; description: string | null; photoUrl: string | null; /** Ids of listServices().services[] this staff member performs. */ serviceIds: string[]; /** Pass this, never id, as bookAppointment's resourceId. */ resourceId: string | null; } interface ListStaffResult { staff: WixStaffMember[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/listStaffCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.listStaff({ site: "<site>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.listStaff({"site": "<site>"}))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/listStaff \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.listStaff({ site: "<site>" });searchServicesFinds a business's services by words, e.g. 'consultation' or 'beard trim'.Arguments
Name Type Required sitestringYes querystringWords to match, e.g. "consultation" or "beard trim".Yes limitnumberMax services returned (default 50, max 200).No Returns
WixServiceListinterface WixServicePayment { inPerson: boolean; online: boolean; deposit: boolean; pricingPlan: boolean; } interface WixService { id: string; name: string; description: string | null; /** Wix's own kind: "APPOINTMENT", "CLASS" or "COURSE". */ type: string; durationMinutes: number | null; price: string | null; currency: string | null; payment: WixServicePayment; onlineBookingEnabled: boolean; staffMemberIds: string[]; /** The id getOpenTimes resolves to a schedule, present only on an appointment-type service. */ scheduleId: string | null; bookingPageUrl: string | null; /** This same id comes back from listCategories. */ categoryId: string | null; categoryName: string | null; checkout: WixCheckout | null; } interface WixCheckout { status: "ready_to_checkout" | "needs_login" | "unavailable"; /** Always https, on the studio's own site. */ url: string; /** ready_to_checkout only: carries_items opens this very slot, product_page opens the studio's schedule. */ urlKind?: "carries_items" | "signed_in_cart" | "product_page"; /** unavailable only: out_of_stock (class full, no waitlist) or not_available_for_dates (cancelled). */ reason?: string; detail?: string; account: { site: string; hint: string; signedInAs?: string; signInUrl?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string; /** ISO start/end of the class or slot, with the studio's UTC offset when the site gives one. */ dates?: { start: string; end?: string }; } | null; warnings: string[]; } interface WixServiceList { services: WixService[]; total: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/searchServicesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.searchServices({ site: "<site>", query: "<query>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.searchServices({"site": "<site>", "query": "<query>"}))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/searchServices \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>","query":"<query>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.searchServices({ site: "<site>", query: "<query>" });
bookAppointmentBooks an appointment as a guest for a service at an open time, with the customer's name, email and phone.Arguments
Name Type Required sitestringYes serviceIdstringA service id from listServices().services[].id.Yes startDatestringFrom an open slot in getOpenTimes().slots[].Yes endDatestringYes timeZonestringDefaults to the service's own zone when omitted.No resourceIdstringA listStaff().staff[].resourceId; defaults to the service's own first staff member.No contactWixBookingContactYes numberOfParticipantsnumberDefault 1.No Returns
WixBookinginterface WixBookingContact { firstName: string; lastName: string; email: string; phone?: string; } interface WixBooking { id: string; /** Pass this back verbatim to cancelBooking/rescheduleBooking. */ revision: string; /** The site's own label, e.g. "CREATED" or "CANCELED", read the value off a result, never guess one from prose. */ status: string; serviceId: string; startDate: string; endDate: string; timeZone: string | null; resourceId: string | null; resourceName: string | null; numberOfParticipants: number | null; contact: WixBookingContact; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/bookAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.bookAppointment({ site: "<site>", serviceId: "<serviceId>", startDate: "<startDate>", endDate: "<endDate>", contact: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.bookAppointment({ "site": "<site>", "serviceId": "<serviceId>", "startDate": "<startDate>", "endDate": "<endDate>", "contact": {} }))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/bookAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>","serviceId":"<serviceId>","startDate":"<startDate>","endDate":"<endDate>","contact":{}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.bookAppointment({ site: "<site>", serviceId: "<serviceId>", startDate: "<startDate>", endDate: "<endDate>", contact: {} });cancelBookingCancels a guest booking with no sign-in, given the booking's id and current revision from bookAppointment.Arguments
Name Type Required sitestringYes bookingIdstringYes revisionstringFrom bookAppointment()'s own revision.Yes notifyParticipantsbooleanNotify the business's own staff.No Returns
WixBookinginterface WixBookingContact { firstName: string; lastName: string; email: string; phone?: string; } interface WixBooking { id: string; /** Pass this back verbatim to cancelBooking/rescheduleBooking. */ revision: string; /** The site's own label, e.g. "CREATED" or "CANCELED", read the value off a result, never guess one from prose. */ status: string; serviceId: string; startDate: string; endDate: string; timeZone: string | null; resourceId: string | null; resourceName: string | null; numberOfParticipants: number | null; contact: WixBookingContact; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/wix_bookings/cancelBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.wix_bookings.cancelBooking({ site: "<site>", bookingId: "<bookingId>", revision: "<revision>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.wix_bookings.cancelBooking({ "site": "<site>", "bookingId": "<bookingId>", "revision": "<revision>" }))curl -X POST https://api.bowmark.ai/v1/sites/wix_bookings/cancelBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>","bookingId":"<bookingId>","revision":"<revision>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.wix_bookings.cancelBooking({ site: "<site>", bookingId: "<bookingId>", revision: "<revision>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/wix_bookings/<function> - OpenAPI
/v1/sites/wix_bookings/openapi.json