Skip to main content
Glama

Acuity Scheduling MCP by usefulapi

by io.usefulapi
OverviewDiscussionsAdmin

Server Details

Read appointments, types, calendars and availability; create, cancel or reschedule bookings.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
81.0% over 54 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

A3.8/5.0

Scored across 18 tools

Disambiguation5/5

Each tool targets a distinct resource or action: availability lookups (classes/dates/times) are clearly separated by granularity, and appointment operations (create/get/list/cancel/reschedule) are unambiguous. The remaining list_* and create_* tools map to unique entities like clients, calendars, forms, and products, so there is no meaningful overlap.

Naming Consistency4/5

Tool names mostly follow a consistent acuity_<action>_<resource> pattern with a clear prefix. The availability_* trio is the only notable deviation, using a noun-like resource phrase instead of an explicit verb such as list_.

Tool Count4/5

Eighteen tools is slightly above the ideal 3–15 range, but the count is justified by the breadth of Acuity's domain: availability, appointments, clients, calendars, forms, labels, orders, and products. Each tool maps to a meaningful API operation, so the set feels comprehensive rather than bloated.

Completeness4/5

The core appointment lifecycle is well covered: check availability, book, list, read, cancel, and reschedule. Minor gaps exist such as no update/delete for clients or appointment types, but these are peripheral to the main scheduling workflow.

Available Tools

18 tools
acuity_availability_classesGet available classes
Read-only
Inspect

List group class time slots (for class-type appointment types) in a month. Acuity REST: GET /availability/classes.

ParametersJSON Schema
NameRequiredDescriptionDefault
monthYesMonth to check, formatted YYYY-MM, e.g. '2026-08'.
timezoneNoIANA timezone for the returned times, e.g. 'America/New_York'.
appointmentTypeIDYesClass appointment type id (required).
includeUnavailableNoIf true, also include full/unavailable class times.
acuity_availability_datesGet available dates
Read-only
Inspect

List dates in a month that have availability for an appointment type. Acuity REST: GET /availability/dates.

ParametersJSON Schema
NameRequiredDescriptionDefault
monthYesMonth to check, formatted YYYY-MM, e.g. '2026-08'.
timezoneNoIANA timezone for the returned dates, e.g. 'America/New_York'.
calendarIDNoRestrict to a specific calendar id.
appointmentTypeIDYesAppointment type id to check availability for (required).
acuity_availability_timesGet available times
Read-only
Inspect

List available time slots on a given date for an appointment type. Acuity REST: GET /availability/times.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesDate to check, formatted YYYY-MM-DD, e.g. '2026-08-15'.
timezoneNoIANA timezone for the returned times, e.g. 'America/New_York'.
calendarIDNoRestrict to a specific calendar id.
appointmentTypeIDYesAppointment type id to check availability for (required).
acuity_cancel_appointmentCancel appointment
Destructive
Inspect

CANCELS an existing appointment. This MODIFIES the calendar and, unless suppressed, may send cancellation emails. Acuity REST: PUT /appointments/{id}/cancel.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesAppointment id to cancel (required).
adminNoIf true, cancel as admin (bypasses client cancellation restrictions).
noEmailNoIf true, suppress cancellation emails.
cancelNoteNoOptional note explaining the cancellation.
acuity_create_appointmentCreate appointment
Destructive
Inspect

CREATES a new appointment (books a client into a time slot). This MODIFIES the calendar and, unless suppressed, may send confirmation emails. Acuity REST: POST /appointments.

ParametersJSON Schema
NameRequiredDescriptionDefault
adminNoIf true, book as admin — bypasses availability checks and required-form enforcement. Default false.
emailYesClient email (required).
notesNoNotes to attach to the appointment.
phoneNoClient phone number.
fieldsNoIntake form field answers, each { id, value }.
noEmailNoIf true, suppress client/owner confirmation emails.
datetimeYesStart time in ISO 8601 with offset, e.g. '2026-08-15T14:00:00-0400' (required).
lastNameYesClient last name (required).
timezoneNoIANA timezone for the datetime, e.g. 'America/New_York'.
firstNameYesClient first name (required).
calendarIDNoCalendar id to book on (defaults to an available one).
appointmentTypeIDYesAppointment type id to book (required).
acuity_create_clientCreate client
Destructive
Inspect

CREATES a new client record in the account's client list. This ADDS data to the account. Acuity REST: POST /clients.

ParametersJSON Schema
NameRequiredDescriptionDefault
emailNoClient email.
notesNoNotes about the client.
phoneNoClient phone number.
lastNameYesClient last name (required).
firstNameYesClient first name (required).
acuity_get_appointmentGet appointment
Read-only
Inspect

Get a single appointment by its id. Acuity REST: GET /appointments/{id}.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesAppointment id.
acuity_get_meGet account info
Read-only
Inspect

Get the authenticated Acuity account's profile (name, email, timezone, plan, currency). Acuity REST: GET /me.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

acuity_list_appointmentsList appointments
Read-only
Inspect

List appointments scheduled on the account, with optional filters. Acuity REST: GET /appointments.

ParametersJSON Schema
NameRequiredDescriptionDefault
maxNoMax appointments to return.
emailNoFilter by client email.
maxDateNoOnly appointments on/before this date (YYYY-MM-DD or ISO datetime).
minDateNoOnly appointments on/after this date (YYYY-MM-DD or ISO datetime).
canceledNoIf true, return canceled appointments (default false).
lastNameNoFilter by client last name.
directionNoSort order by datetime. ASC (default) or DESC.
firstNameNoFilter by client first name.
calendarIDNoFilter to a specific calendar id.
appointmentTypeIDNoFilter to a specific appointment type id.
acuity_list_appointment_typesList appointment types
Read-only
Inspect

List the account's appointment types (services and classes), including price, duration and calendars. Acuity REST: GET /appointment-types.

ParametersJSON Schema
NameRequiredDescriptionDefault
includeDeletedNoIf true, also include deleted/inactive appointment types.
acuity_list_blocksList blocked-off times
Read-only
Inspect

List blocked-off (unavailable) time ranges on the account's calendars. Acuity REST: GET /blocks.

ParametersJSON Schema
NameRequiredDescriptionDefault
maxNoMax blocks to return.
maxDateNoOnly blocks on/before this date (YYYY-MM-DD or ISO datetime).
minDateNoOnly blocks on/after this date (YYYY-MM-DD or ISO datetime).
calendarIDNoFilter to a specific calendar id.
acuity_list_calendarsList calendars
Read-only
Inspect

List the account's calendars (staff/resources appointments can be booked on). Acuity REST: GET /calendars.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

acuity_list_clientsList clients
Read-only
Inspect

List clients on the account, optionally filtered by a search string (name/email/phone). Acuity REST: GET /clients.

ParametersJSON Schema
NameRequiredDescriptionDefault
searchNoOptional search string to match client name, email, or phone.
acuity_list_formsList intake forms
Read-only
Inspect

List the account's custom intake forms and their fields. Acuity REST: GET /forms.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

acuity_list_labelsList labels
Read-only
Inspect

List the appointment labels (colored tags) defined on the account. Acuity REST: GET /labels.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

acuity_list_ordersList orders
Read-only
Inspect

List store orders (product / package / gift-certificate purchases). Acuity REST: GET /orders.

ParametersJSON Schema
NameRequiredDescriptionDefault
maxNoMax orders to return.
emailNoFilter orders by buyer email.
acuity_list_productsList products
Read-only
Inspect

List the account's products / packages / gift certificates for sale. Acuity REST: GET /products.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

acuity_reschedule_appointmentReschedule appointment
Destructive
Inspect

RESCHEDULES an existing appointment to a new time (and optionally a new calendar). This MODIFIES the calendar and, unless suppressed, may send update emails. Acuity REST: PUT /appointments/{id}/reschedule.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesAppointment id to reschedule (required).
adminNoIf true, reschedule as admin (bypasses availability checks).
noEmailNoIf true, suppress reschedule emails.
datetimeYesNew start time in ISO 8601 with offset, e.g. '2026-08-16T10:00:00-0400' (required).
calendarIDNoMove the appointment to this calendar id.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 18 tool updates
    • Changedacuity_availability_classes1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_availability_dates1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_availability_times1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_cancel_appointment1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_create_appointment1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_create_client1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_get_appointment1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_get_me1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_appointment_types1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_appointments1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_blocks1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_calendars1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_clients1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_forms1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_labels1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_orders1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_list_products1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedacuity_reschedule_appointment1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. 18 tool updates
    • First observedacuity_availability_classes
    • First observedacuity_availability_dates
    • First observedacuity_availability_times
    • First observedacuity_cancel_appointment
    • First observedacuity_create_appointment
    • First observedacuity_create_client
    • First observedacuity_get_appointment
    • First observedacuity_get_me
    • First observedacuity_list_appointment_types
    • First observedacuity_list_appointments
    • First observedacuity_list_blocks
    • First observedacuity_list_calendars
    • First observedacuity_list_clients
    • First observedacuity_list_forms
    • First observedacuity_list_labels
    • First observedacuity_list_orders
    • First observedacuity_list_products
    • First observedacuity_reschedule_appointment

Related MCP Connectors

Related MCP Servers

  • clinic-engine

    arturio-amorim
    A
    license
    Not graded
    quality
    B
    maintenance
    Provides MCP tools to list valid appointment slots, schedule, reschedule, and cancel appointments under a clinic's business policy (hours, buffers, minimum notice, practitioner availability).
    1
    MIT

  • Appointedd MCP Server

    dragosh29
    A
    license
    A
    quality
    C
    maintenance
    Enables MCP clients to search availability, read services, resources, bookings and customers, and, when writes are enabled, reserve slots, create or cancel bookings, and add or update customers.
    10
    MIT

  • vitta-mcp

    leonardobrigolini
    A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to look up businesses, find free appointment slots, book, list and cancel appointments at salons, barbershops, nail and brow studios and clinics. Works read-only without a customer login by returning a pre-filled booking link, and can also run against a built-in demo with sample businesses.
    5
    MIT
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources