Acuity Scheduling MCP server for AI agents

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

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

Connect

Just Acuity Scheduling

An MCP server for Acuity Scheduling 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/acuityscheduling
Every site

One MCP server for Acuity Scheduling 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 11
  • findSchedulerFinds one business's Acuity scheduler and its owner id from the business name (tried as its own <name>.as.me address), or from its as.me address, an…

    Arguments

    NameTypeRequired
    querystringYes

    Returns AcuityScheduler

    interface AcuityScheduler {
      /** The numeric owner id every Acuity scheduling page is keyed on. */
      ownerId: string;
      ownerKey: string | null;
      /** The business name as the business set it in Acuity. */
      name: string;
      /** https://app.acuityscheduling.com/schedule.php?owner=<ownerId> */
      schedulingUrl: string;
      /** The business's own https://<slug>.as.me/ address, when it has one. */
      prettyUrl: string | null;
      timezone: string | null;
      country: string | null;
      isExpired: boolean;
      matchedBy: "name" | "as.me" | "acuity-link" | "business-site" | "owner-id";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/findScheduler

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.findScheduler("304 Collective");
  • getAppointmentTypeDetailsReturns details of a specific appointment type including duration, provider, and capacity.

    Arguments

    NameTypeRequired
    querystringYes
    appointmentTypeIdstringYes

    Returns AcuityAppointmentType

    interface AcuityAppointmentType {
      id: number;
      name: string;
      category: string;
      active: boolean;
      description: string;
      duration: number;
      price: string;
      private: boolean;
      type: string;
      classSize: number | null;
      calendarIDs: number[];
      addonIDs: number[];
      formIDs: number[];
      paymentRequired: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/getAppointmentTypeDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.getAppointmentTypeDetails("304 Collective", "70283385");
  • getBookingFormReturns the form fields and requirements needed to complete a booking.

    Arguments

    NameTypeRequired
    querystringYes
    appointmentTypeIdstringNo

    Returns AcuityBookingForm

    interface AcuityFormField {
      fieldID: number;
      name: string;
      /** TEXTBOX, TEXTAREA, DROPDOWN, CHECKBOX, CHECKBOX_LIST, YESNO, FILE, ADDRESS */
      type: string;
      isRequired: boolean;
      options: string[];
    }
    
    interface AcuityForm {
      id: number;
      name: string;
      description: string;
      fields: AcuityFormField[];
    }
    
    interface AcuityBookingForm {
      clientFields: { name: "firstName" | "lastName" | "email" | "phone"; isRequired: boolean }[];
      forms: AcuityForm[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/getBookingForm

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.getBookingForm("304 Collective");
  • getPriceReturns pricing for an appointment type, including discounts for multi-class packages.

    Arguments

    NameTypeRequired
    querystringYes
    appointmentTypeIdstringYes

    Returns AcuityPrice

    interface AcuityPack {
      id: number;
      title: string;
      description: string;
      category: string;
      /** In the business's currency. */
      price: number;
      formattedPrice: string;
      isSubscription: boolean;
      subscriptionTermsText: string;
      thumbnailUrl: string | null;
      /** The business's catalog page, where the pack is bought. */
      catalogUrl: string;
    }
    
    interface AcuityPrice {
      appointmentTypeId: number;
      name: string;
      /** Single-booking price, a decimal string ("165.00"). */
      price: string;
      currency: string | null;
      paymentRequired: boolean;
      /** Every non-subscription pack the business sells; Acuity does not publish which
       * types a pack covers, so match by title. */
      packs: (AcuityPack & { sessions: number | null; perSession: number | null })[];
      cheapestPerSession: { packId: number; perSession: number } | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/getPrice

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.getPrice("19712135", "31865874");
  • getSchedulerInfoReturns the business's Acuity profile and booking policies (reschedule, cancel, waitlist, tipping, phone required).

    Arguments

    NameTypeRequired
    querystringYes

    Returns AcuitySchedulerInfo

    interface AcuitySchedulerInfo {
      ownerId: string;
      name: string;
      description: string;
      logoUrl: string | null;
      schedulingUrl: string;
      prettyUrl: string | null;
      catalogUrl: string | null;
      timezone: string | null;
      country: string | null;
      language: string | null;
      /** ISO code, e.g. "USD". */
      currency: string | null;
      isExpired: boolean;
      policies: {
        canClientsReschedule: boolean;
        canClientsCancel: boolean;
        waitlist: boolean;
        classWaitlist: boolean;
        tipping: boolean;
        phoneRequired: boolean;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/getSchedulerInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.getSchedulerInfo("304 Collective");
  • listAppointmentTypesLists all appointment types (classes, services) offered by the business.

    Arguments

    NameTypeRequired
    querystringYes

    Returns AcuityAppointmentType[]

    interface AcuityAppointmentType {
      id: number;
      name: string;
      category: string;
      active: boolean;
      description: string;
      duration: number;
      price: string;
      private: boolean;
      type: string;
      classSize: number | null;
      calendarIDs: number[];
      addonIDs: number[];
      formIDs: number[];
      paymentRequired: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/listAppointmentTypes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.listAppointmentTypes("304 Collective");
  • listLocationsLists all service locations available for this business.

    Arguments

    NameTypeRequired
    querystringYes

    Returns AcuityLocation[]

    interface AcuityLocation {
      id: number;
      name: string;
      description: string;
      location: string;
      timezone: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/listLocations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.listLocations("304 Collective");
  • listMyBookingsLists the signed-in caller's appointments at one business, each with the link Acuity gives a client to view, cancel or reschedule it.

    Arguments

    NameTypeRequired
    querystringYes

    Returns AcuityMyBookings

    interface AcuityMyBookings {
      ownerId: string;
      business: string;
      /** Each appointment's unique id and the link Acuity gives a client to view, cancel or reschedule it. */
      bookings: { appointmentId: string; manageUrl: string }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/listMyBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.listMyBookings("19712135");
  • listPacksLists multi-class packages with discounted per-class pricing.

    Arguments

    NameTypeRequired
    querystringYes

    Returns AcuityPack[]

    interface AcuityPack {
      id: number;
      title: string;
      description: string;
      category: string;
      /** In the business's currency. */
      price: number;
      formattedPrice: string;
      isSubscription: boolean;
      subscriptionTermsText: string;
      thumbnailUrl: string | null;
      /** The business's catalog page, where the pack is bought. */
      catalogUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/listPacks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.listPacks("19712135");
  • listScheduleSlotsLists open start times for one appointment type over a date range, optionally for one calendar.

    Arguments

    NameTypeRequired
    querystringYes
    appointmentTypeIdstringYes
    options.fromstring
    First day, YYYY-MM-DD; default today.
    No
    options.daysnumber
    How many days from from, 1-31; default 7.
    No
    options.calendarIdstring
    One calendar id off listLocations; default every calendar.
    No

    Returns AcuitySchedule

    interface AcuitySlot {
    
      time: string;
      slotsAvailable: number;
    }
    
    interface AcuitySchedule {
      appointmentTypeId: number;
      /** The business's timezone the times are in. */
      timezone: string;
      from: string;
      to: string;
      /** Only days with at least one open time. */
      days: { date: string; slots: AcuitySlot[] }[];
      /** Where a person picks one of these times and books it. */
      bookingUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/listScheduleSlots

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.listScheduleSlots("19712135", "31865874", { days: 31 });
  • searchScheduleFinds open times across every public class at once, filtered by class text and location, over a date range.

    Arguments

    NameTypeRequired
    querystringYes
    options.fromstring
    First day, YYYY-MM-DD; default today.
    No
    options.daysnumber
    How many days from from, 1-31; default 7.
    No
    options.locationstring
    Matched against each calendar's name and address (listLocations); default every location.
    No
    options.textstring
    Matched against each class's name, category and description; default every public class.
    No

    Returns AcuityScheduleSearch

    interface AcuityScheduleSearch {
      timezone: string;
      from: string;
      to: string;
      /** How many class/location combinations were asked (at most 12). */
      searched: number;
      /** Every open time across them, earliest first. */
      slots: {
        date: string;
        time: string;
        slotsAvailable: number;
        appointmentTypeId: number;
        appointmentTypeName: string;
        /** Set when `location` was given. */
        calendarId: number | null;
        calendarName: string | null;
        bookingUrl: string;
      }[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/searchSchedule

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.searchSchedule("19712135", { days: 31 });
Act 2
  • cancelAppointmentCancels a booking; caller must own the appointment.

    Arguments

    NameTypeRequired
    querystringYes
    appointmentIdstringYes

    Returns AcuityAppointmentChange

    interface AcuityAppointmentChange {
      ownerId: string;
      business: string;
      appointmentId: string;
      action: "canceled" | "rescheduled";
      /** The changed appointment(s) exactly as Acuity's scheduler answered them. */
      appointments: unknown[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.cancelAppointment("<query>", "<appointmentId>");
  • rescheduleAppointmentReschedules a booking to a different date/time; caller must own the appointment.

    Arguments

    NameTypeRequired
    querystringYes
    appointmentIdstringYes
    target.datetimestring
    The new start time, a time from listScheduleSlots (ISO 8601 with offset).
    Yes
    target.calendarIdstring | number
    The calendar that time belongs to.
    Yes
    target.timezonestring
    IANA timezone of the time; defaults to the business's own.
    No

    Returns AcuityAppointmentChange

    interface AcuityAppointmentChange {
      ownerId: string;
      business: string;
      appointmentId: string;
      action: "canceled" | "rescheduled";
      /** The changed appointment(s) exactly as Acuity's scheduler answered them. */
      appointments: unknown[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/acuityscheduling/rescheduleAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.acuityscheduling.rescheduleAppointment("<query>", "<appointmentId>", { datetime: "<datetime>", calendarId: "<calendarId>" });

Use it from code