Bookedin MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Bookedin: 15 typed functions through one MCP server. No Bookedin API key needed.

Functions
15
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Bookedin

An MCP server for Bookedin 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/bookedin
Every site

One MCP server for Bookedin 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

Open a function to see its arguments, what it returns and how to call it.

Read 10
  • getAvailabilityReturns the open appointment times on one day for a service, optionally narrowed to one staff member.

    Arguments

    NameTypeRequired
    merchantstringYes
    servicestring
    Service id from listServices.
    Yes
    datestring
    YYYY-MM-DD, a day in the business's time zone.
    Yes
    staffstring
    Staff id from listStaff; omit for anyone.
    No

    Returns BookedinAvailability

    interface BookedinSlot {
      /** ISO 8601 UTC instant. */
      start: string;
      /** HH:MM in the business's time zone. */
      localTime: string;
      staffId: string;
      staffName: string | null;
    }
    
    interface BookedinAvailability {
      token: string;
      date: string;
      timeZone: string;
      service: { id: string; name: string | null };
      bookable: boolean;
      nonRefundable: boolean;
      slots: BookedinSlot[];
      /** When date has no openings, the nearest day that does (call again with it). */
      nearestDate: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/getAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.getAvailability({
      merchant: "bookedin-specialists",
      service: "5743265411366912",
      date: { $daysFromNow: 60 }
    });
  • getAvailableDatesReturns which days in a date range have open times for a service (and optionally a staff member), so a caller can pick a day before asking for exact…

    Arguments

    NameTypeRequired
    merchantstring
    Booking token or bookedin.com/book/<token> URL.
    Yes
    servicestring
    Service id from listServices.
    Yes
    staffstring
    Staff id from listStaff; omit for anyone.
    No
    fromstring
    YYYY-MM-DD; defaults to today.
    No
    tostring
    YYYY-MM-DD; defaults to from + 13 days, at most 62 days after from.
    No

    Returns BookedinAvailableDates

    interface BookedinAvailableDates {
      token: string;
      service: string;
      staff: string | null;
      /** The business's time zone; every date is a day there. */
      timeZone: string;
      from: string;
      to: string;
      days: { date: string; openTimes: number }[];
      bookableUntil: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/getAvailableDates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.getAvailableDates({
      merchant: "bookedin-specialists",
      service: "5743265411366912"
    });
  • getClassDatesLists which days in a date range have open class sessions at a business that runs classes or workshops, and how many on each.

    Arguments

    NameTypeRequired
    merchantstring
    Booking token or bookedin.com/book/<token> URL.
    Yes
    fromstring
    YYYY-MM-DD; defaults to today.
    No
    tostring
    YYYY-MM-DD; defaults to from + 13 days, at most 62 days after from.
    No

    Returns BookedinClassAvailableDates

    interface BookedinClassAvailableDates {
      token: string;
      timeZone: string;
      from: string;
      to: string;
      days: { date: string; openSessions: number }[];
      bookableUntil: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/getClassDates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.getClassDates({
      merchant: "rgv-eye-center",
      from: { $daysFromNow: 70 },
      to: { $daysFromNow: 87 }
    });
  • getClassSessionReads one class session's details.

    Arguments

    NameTypeRequired
    merchantstringYes
    sessionstring
    Session id from listClassSessions.
    Yes

    Returns BookedinClassSession

    interface BookedinClassSession {
      session: string;
      classId: string;
      className: string | null;
      category: string | null;
      price: string | null;
      description: string | null;
      start: string;
      end: string;
      localDate: string;
      localTime: string;
      timeZone: string;
      instructor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/getClassSession

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.getClassSession({ merchant: "rgv-eye-center", session: "5473242671611904" });
  • getMerchantRetrieves one business's record from its booking token or its bookedin.com/book/<token> URL: name, address, phone, time zone, currency, business…

    Arguments

    NameTypeRequired
    merchantstring
    Booking token or bookedin.com/book/<token> URL.
    Yes

    Returns BookedinMerchant

    interface BookedinMerchantSummary {
      token: string;
      name: string;
      bookingUrl: string;
      address: string | null;
      city: string | null;
      province: string | null;
      country: string;
      postalCode: string | null;
      phone: string | null;
      website: string | null;
    
      checkout: BookedinCheckout | null;
    }
    
    interface BookedinCheckout {
      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 BookedinMerchant extends BookedinMerchantSummary {
      email: string | null;
      timeZone: string | null;
      currency: string | null;
      businessType: string | null;
      category: string | null;
      imageUrl: string | null;
      takesAppointments: boolean;
      takesClasses: boolean;
      serviceCount: number;
      staffCount: number;
      classCount: number;
      workshopCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/getMerchant

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.getMerchant({ merchant: "bookedin-specialists" });
  • listClassSessionsLists the class sessions on one day with their class, category, price, instructor, time and free spaces; a day with none names the nearest day that…

    Arguments

    NameTypeRequired
    merchantstringYes
    datestring
    YYYY-MM-DD, a day in the business's time zone.
    Yes

    Returns BookedinClassSessionList

    interface BookedinClassSessionSlot {
      /** Pass to getClassSession. */
      session: string;
      classId: string;
      className: string | null;
      category: string | null;
      price: string | null;
      start: string;
      localTime: string;
      instructor: string | null;
      freeSpaces: number;
    }
    
    interface BookedinClassSessionList {
      token: string;
      date: string;
      timeZone: string;
      sessions: BookedinClassSessionSlot[];
      /** When date has no sessions of its own, the nearest day that does (call again with it). */
      nearestDate: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/listClassSessions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.listClassSessions({ merchant: "<merchant>", date: "<date>" });
  • listRegionsLists the countries Bookedin's public directory covers (AU, CA, GB, IE, NZ, SE, US) and, for one country, its states or provinces.

    Arguments

    NameTypeRequired
    countrystring
    Two-letter country code; omit to list the countries.
    No

    Returns BookedinRegionList

    interface BookedinRegion {
      code: string;
      name: string;
    }
    
    interface BookedinRegionList {
      country: BookedinRegion | null;
      regions: BookedinRegion[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/listRegions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.listRegions({ country: "US" });
  • listServicesLists every appointment service a business offers, grouped by category, with price, duration and description.

    Arguments

    NameTypeRequired
    merchantstring
    Booking token or bookedin.com/book/<token> URL.
    Yes

    Returns BookedinServiceList

    interface BookedinServiceAddOn {
      id: string;
      name: string;
      price: string | null;
      durationMinutes: number | null;
    }
    
    interface BookedinService {
      /** Pass to getAvailability / bookAppointment. */
      id: string;
      name: string;
      category: string | null;
      description: string | null;
      /** The business's own formatted price ("$45.00"); null when it shows none. */
      price: string | null;
      durationMinutes: number | null;
      duration: string | null;
      videoCall: boolean;
      nonRefundable: boolean;
      /** Staff ids (listStaff) who offer it. */
      staffIds: string[];
      addOns: BookedinServiceAddOn[];
    }
    
    interface BookedinServiceList {
      token: string;
      categories: { name: string; services: BookedinService[] }[];
      services: BookedinService[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/listServices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.listServices({ merchant: "bookedin-specialists" });
  • listStaffLists the staff members (resources) a caller can book with at a business, with names and photos.

    Arguments

    NameTypeRequired
    merchantstring
    Booking token or bookedin.com/book/<token> URL.
    Yes

    Returns BookedinStaffList

    interface BookedinStaffMember {
      id: string;
      name: string;
      photoUrl: string | null;
      /** Ids of the services this person offers. */
      serviceIds: string[];
    }
    
    interface BookedinStaffList {
      token: string;
      staff: BookedinStaffMember[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/listStaff

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.listStaff({ merchant: "bookedin-specialists" });
  • searchMerchantsFinds Bookedin businesses by name, city or business type inside one country and state/province of the public directory, returning each one's booking…

    Arguments

    NameTypeRequired
    countrystringYes
    provincestring
    State/province code; required for a country listed by region (US, CA).
    No
    querystring
    Words matched against name, city and token.
    No
    limitnumberNo

    Returns BookedinSearchResult

    interface BookedinMerchantSummary {
      token: string;
      name: string;
      bookingUrl: string;
      address: string | null;
      city: string | null;
      province: string | null;
      country: string;
      postalCode: string | null;
      phone: string | null;
      website: string | null;
    
      checkout: BookedinCheckout | null;
    }
    
    interface BookedinCheckout {
      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 BookedinSearchResult {
      country: string;
      province: string | null;
      listed: number;
      merchants: BookedinMerchantSummary[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/searchMerchants

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.searchMerchants({ country: "US", province: "TX" });
Act 5
  • bookAppointmentBooks an appointment as a guest with name, email and phone at a chosen service, staff member and time, answering the business's own booking questions.

    Arguments

    NameTypeRequired
    merchantstringYes
    servicestring
    Service id from listServices.
    Yes
    staffstring
    Staff id from listStaff; omit to take whoever the slot names.
    No
    startstring
    A slot's start (ISO UTC instant) from getAvailability.
    Yes
    namestring
    First and last name.
    Yes
    emailstringYes
    phonestringYes
    notestringNo
    answersRecord<string, string>
    The business's own booking questions, keyed by field name.
    No

    Returns BookedinBooking

    interface BookedinBooking {
      token: string;
      service: string;
      staffId: string;
      start: string;
      /** True only when Bookedin said the booking succeeded. */
      booked: boolean;
      appointmentId: string | null;
      message: string | null;
      /** The business wants its new-client questions answered; re-call with answers. */
      newClientFieldsRequired: boolean;
      /** A deposit is due up front; never paid by this function. */
      paymentRequired: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/bookAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.bookAppointment({
      merchant: "<merchant>",
      service: "<service>",
      start: "<start>",
      name: "<name>",
      email: "<email>",
      phone: "<phone>"
    });
  • cancelAppointmentCancels an appointment from the cancel link in its Bookedin confirmation email (or its id and key).

    Arguments

    NameTypeRequired
    linkstring
    The cancel/confirm link from the Bookedin email: bookedin.com/book/<token>/update?id&h&key&method.
    No
    merchantstring
    Or its parts: business token, appointment id, h and key.
    No
    idstringNo
    hstringNo
    keystringNo

    Returns BookedinAppointmentUpdate

    interface BookedinAppointmentUpdate {
      token: string;
      appointmentId: string;
      action: "cancel" | "confirm";
      /** "appointment", or "class" for cancelClassBooking. */
      kind: "appointment" | "class";
      /** True only when Bookedin said it succeeded. */
      done: boolean;
      message: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/cancelAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.cancelAppointment({});
  • cancelClassBookingCancels a class registration from the cancel link in its confirmation email.

    Arguments

    NameTypeRequired
    linkstring
    The cancel/confirm link from the Bookedin email: bookedin.com/book/<token>/update?id&h&key&method.
    No
    merchantstring
    Or its parts: business token, appointment id, h and key.
    No
    idstringNo
    hstringNo
    keystringNo

    Returns BookedinAppointmentUpdate

    interface BookedinAppointmentUpdate {
      token: string;
      appointmentId: string;
      action: "cancel" | "confirm";
      /** "appointment", or "class" for cancelClassBooking. */
      kind: "appointment" | "class";
      /** True only when Bookedin said it succeeded. */
      done: boolean;
      message: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/cancelClassBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.cancelClassBooking({});
  • confirmAppointmentConfirms an appointment from the confirm link in a Bookedin reminder email.

    Arguments

    NameTypeRequired
    linkstring
    The cancel/confirm link from the Bookedin email: bookedin.com/book/<token>/update?id&h&key&method.
    No
    merchantstring
    Or its parts: business token, appointment id, h and key.
    No
    idstringNo
    hstringNo
    keystringNo

    Returns BookedinAppointmentUpdate

    interface BookedinAppointmentUpdate {
      token: string;
      appointmentId: string;
      action: "cancel" | "confirm";
      /** "appointment", or "class" for cancelClassBooking. */
      kind: "appointment" | "class";
      /** True only when Bookedin said it succeeded. */
      done: boolean;
      message: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/confirmAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.confirmAppointment({});
  • requestAppointmentSends an appointment request to a business that takes requests instead of instant booking.

    Arguments

    NameTypeRequired
    merchantstring
    Booking token from searchMerchants, or the bookedin.com/book/<token> URL.
    Yes
    servicestring
    What the caller wants, in words.
    Yes
    preferredTimestring
    When the caller would like it, in words.
    Yes
    namestring
    First and last name.
    Yes
    emailstringYes
    phonestringYes
    commentsstringNo
    forClassWorkshopboolean
    The request is for a class or workshop rather than an appointment.
    No

    Returns BookedinAppointmentRequest

    interface BookedinAppointmentRequest {
      token: string;
      /** True when Bookedin accepted the request. */
      requested: boolean;
      service: string;
      preferredTime: string;
      forClassWorkshop: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookedin/requestAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookedin.requestAppointment({
      merchant: "<merchant>",
      service: "<service>",
      preferredTime: "<preferredTime>",
      name: "<name>",
      email: "<email>",
      phone: "<phone>"
    });

Use it from code