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
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/acuityschedulingOne 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/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.
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
Name Type Required querystringYes Returns
AcuitySchedulerinterface 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/findSchedulerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.findScheduler("304 Collective");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.findScheduler("304 Collective"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/findScheduler \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"304 Collective"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.findScheduler("304 Collective");getAppointmentTypeDetailsReturns details of a specific appointment type including duration, provider, and capacity.Arguments
Name Type Required querystringYes appointmentTypeIdstringYes Returns
AcuityAppointmentTypeinterface 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/getAppointmentTypeDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.getAppointmentTypeDetails("304 Collective", "70283385");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.getAppointmentTypeDetails("304 Collective", "70283385"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/getAppointmentTypeDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"304 Collective","appointmentTypeId":"70283385"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.getAppointmentTypeDetails("304 Collective", "70283385");getBookingFormReturns the form fields and requirements needed to complete a booking.Arguments
Name Type Required querystringYes appointmentTypeIdstringNo Returns
AcuityBookingForminterface 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/getBookingFormCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.getBookingForm("304 Collective");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.getBookingForm("304 Collective"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/getBookingForm \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"304 Collective"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.getBookingForm("304 Collective");getPriceReturns pricing for an appointment type, including discounts for multi-class packages.Arguments
Name Type Required querystringYes appointmentTypeIdstringYes Returns
AcuityPriceinterface 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/getPriceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.getPrice("19712135", "31865874");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.getPrice("19712135", "31865874"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/getPrice \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"19712135","appointmentTypeId":"31865874"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.getPrice("19712135", "31865874");getSchedulerInfoReturns the business's Acuity profile and booking policies (reschedule, cancel, waitlist, tipping, phone required).Arguments
Name Type Required querystringYes Returns
AcuitySchedulerInfointerface 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/getSchedulerInfoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.getSchedulerInfo("304 Collective");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.getSchedulerInfo("304 Collective"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/getSchedulerInfo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"304 Collective"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.getSchedulerInfo("304 Collective");listAppointmentTypesLists all appointment types (classes, services) offered by the business.Arguments
Name Type Required 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/listAppointmentTypesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.listAppointmentTypes("304 Collective");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.listAppointmentTypes("304 Collective"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/listAppointmentTypes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"304 Collective"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.listAppointmentTypes("304 Collective");listLocationsLists all service locations available for this business.Arguments
Name Type Required 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/listLocationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.listLocations("304 Collective");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.listLocations("304 Collective"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/listLocations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"304 Collective"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringYes Returns
AcuityMyBookingsinterface 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/listMyBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.listMyBookings("19712135");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.listMyBookings("19712135"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/listMyBookings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"19712135"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.listMyBookings("19712135");listPacksLists multi-class packages with discounted per-class pricing.Arguments
Name Type Required 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/listPacksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.listPacks("19712135");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.listPacks("19712135"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/listPacks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"19712135"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.listPacks("19712135");listScheduleSlotsLists open start times for one appointment type over a date range, optionally for one calendar.Arguments
Name Type Required querystringYes appointmentTypeIdstringYes options.fromstringFirst day, YYYY-MM-DD; default today.No options.daysnumberHow many days from from, 1-31; default 7.No options.calendarIdstringOne calendar id off listLocations; default every calendar.No Returns
AcuityScheduleinterface 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/listScheduleSlotsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.listScheduleSlots("19712135", "31865874", { days: 31 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.listScheduleSlots("19712135", "31865874", {"days": 31}))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/listScheduleSlots \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"19712135","appointmentTypeId":"31865874","options":{"days":31}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringYes options.fromstringFirst day, YYYY-MM-DD; default today.No options.daysnumberHow many days from from, 1-31; default 7.No options.locationstringMatched against each calendar's name and address (listLocations); default every location.No options.textstringMatched against each class's name, category and description; default every public class.No Returns
AcuityScheduleSearchinterface 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/searchScheduleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.searchSchedule("19712135", { days: 31 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.searchSchedule("19712135", {"days": 31}))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/searchSchedule \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"19712135","options":{"days":31}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.searchSchedule("19712135", { days: 31 });
cancelAppointmentCancels a booking; caller must own the appointment.Arguments
Name Type Required querystringYes appointmentIdstringYes Returns
AcuityAppointmentChangeinterface 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/cancelAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.cancelAppointment("<query>", "<appointmentId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.cancelAppointment("<query>", "<appointmentId>"))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/cancelAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"<query>","appointmentId":"<appointmentId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.cancelAppointment("<query>", "<appointmentId>");rescheduleAppointmentReschedules a booking to a different date/time; caller must own the appointment.Arguments
Name Type Required querystringYes appointmentIdstringYes target.datetimestringThe new start time, a time from listScheduleSlots (ISO 8601 with offset).Yes target.calendarIdstring | numberThe calendar that time belongs to.Yes target.timezonestringIANA timezone of the time; defaults to the business's own.No Returns
AcuityAppointmentChangeinterface 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/rescheduleAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.acuityscheduling.rescheduleAppointment("<query>", "<appointmentId>", { datetime: "<datetime>", calendarId: "<calendarId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.acuityscheduling.rescheduleAppointment("<query>", "<appointmentId>", {"datetime": "<datetime>", "calendarId": "<calendarId>"}))curl -X POST https://api.bowmark.ai/v1/sites/acuityscheduling/rescheduleAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"<query>","appointmentId":"<appointmentId>","target":{"datetime":"<datetime>","calendarId":"<calendarId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.acuityscheduling.rescheduleAppointment("<query>", "<appointmentId>", { datetime: "<datetime>", calendarId: "<calendarId>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/acuityscheduling/<function> - OpenAPI
/v1/sites/acuityscheduling/openapi.json