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.

Functions
10
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Wix Bookings

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_bookings
Every site

One 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/mcp
Set it up in your client

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

Read 8
  • 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

    NameTypeRequired
    sitestringYes

    Returns WixSiteInfo

    interface 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/findSite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    sitestringYes
    serviceIdstring
    A service id from listServices().services[].id.
    Yes
    fromDatestring
    "YYYY-MM-DD", inclusive.
    Yes
    toDatestring
    "YYYY-MM-DD", exclusive.
    Yes
    timeZonestring
    An IANA zone, e.g. "America/New_York".
    No

    Returns WixOpenTimes

    interface 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/getOpenTimes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    sitestringYes
    serviceIdstring
    A service id from listServices().services[].id or searchServices.
    Yes

    Returns WixServiceDetail

    interface 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/getService

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wix_bookings.getService({ site: "<site>", serviceId: "<serviceId>" });
  • listCategoriesLists the categories a business groups its services into.

    Arguments

    NameTypeRequired
    sitestringYes

    Returns ListCategoriesResult

    interface WixCategory { id: string; name: string; sortOrder: number | null; }
    
    interface ListCategoriesResult { categories: WixCategory[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wix_bookings/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wix_bookings.listCategories({ site: "<site>" });
  • listLocationsLists a business's locations with address, phone, email and time zone.

    Arguments

    NameTypeRequired
    sitestringYes

    Returns ListLocationsResult

    interface 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/listLocations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    sitestringYes
    limitnumber
    Max services returned (default 50, max 200).
    No

    Returns WixServiceList

    interface 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/listServices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    sitestringYes

    Returns ListStaffResult

    interface 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/listStaff

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wix_bookings.listStaff({ site: "<site>" });
  • searchServicesFinds a business's services by words, e.g. 'consultation' or 'beard trim'.

    Arguments

    NameTypeRequired
    sitestringYes
    querystring
    Words to match, e.g. "consultation" or "beard trim".
    Yes
    limitnumber
    Max services returned (default 50, max 200).
    No

    Returns WixServiceList

    interface 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/searchServices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wix_bookings.searchServices({ site: "<site>", query: "<query>" });
Act 2
  • bookAppointmentBooks an appointment as a guest for a service at an open time, with the customer's name, email and phone.

    Arguments

    NameTypeRequired
    sitestringYes
    serviceIdstring
    A service id from listServices().services[].id.
    Yes
    startDatestring
    From an open slot in getOpenTimes().slots[].
    Yes
    endDatestringYes
    timeZonestring
    Defaults to the service's own zone when omitted.
    No
    resourceIdstring
    A listStaff().staff[].resourceId; defaults to the service's own first staff member.
    No
    contactWixBookingContactYes
    numberOfParticipantsnumber
    Default 1.
    No

    Returns WixBooking

    interface 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/bookAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    sitestringYes
    bookingIdstringYes
    revisionstring
    From bookAppointment()'s own revision.
    Yes
    notifyParticipantsboolean
    Notify the business's own staff.
    No

    Returns WixBooking

    interface 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/cancelBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wix_bookings.cancelBooking({
      site: "<site>",
      bookingId: "<bookingId>",
      revision: "<revision>"
    });

Use it from code