Acuity Scheduling MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.37.3Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & Workflow Business & Commerce

Server details

Identifier: io.usefulapi/acuity-scheduling
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Facuity-scheduling.svg)](https://sourceweft.com/mcp/io.usefulapi%2Facuity-scheduling?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted MCP server for Acuity Scheduling: read appointments, calendars and availability, and create, cancel or reschedule bookings.

What you can do: List and fetch appointments, with a compact contacts view and pagination
List appointment types, calendars, labels, blocked-off times and account profile
Check available dates, time slots and group class slots for an appointment type
List clients, intake forms, products and store orders
Create, cancel and reschedule appointments, and create client records
Report usage, request a feature, and upgrade or cancel the paid plan
When to use it: Useful when you want an assistant to answer scheduling questions from a live Acuity account, such as what is booked tomorrow or when the next free consultation slot is, and to make or move bookings without opening the Acuity dashboard.
Requirements: Remote endpoint reached over streamable HTTP; no local install. Sign-in is via OAuth, and the login page asks for an Acuity User ID and API Key (Acuity → Integrations → API), stored per user. No API key or Authorization header goes in the client config. A free tier allows 50 tool calls per month.

Before you install

Four tools write to the account: creating, cancelling and rescheduling appointments and creating clients; these change the calendar and may send confirmation, cancellation or update emails unless suppressed. Confirm before running them. Acuity credentials are entered on the hosted login page and stored by the third-party provider. Paid plans cost $9/month or $90/year (Pro) and $39/month or $390/year (Pro+), billed through a Stripe checkout link, with no refund for the current period on…

Installation

In SourceWeft

Open Acuity Scheduling MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Facuity-scheduling/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "acuity-scheduling-by-usefulapi": {
      "type": "http",
      "url": "https://acuity-scheduling.usefulapi.io/mcp"
    }
  }
}

README

Acuity Scheduling MCP by usefulapi

Manage Acuity Scheduling from Claude, Cursor, or any MCP client — read appointments, appointment types, calendars and availability, and create, cancel or reschedule bookings. Hosted, no local install: connect with your Acuity credentials.

Live endpoint: https://acuity-scheduling.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://acuity-scheduling.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http acuity-scheduling https://acuity-scheduling.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

json

{  "mcpServers": {    "acuity-scheduling": {      "url": "https://acuity-scheduling.usefulapi.io/mcp"    }  }}

{  "mcpServers": {    "acuity-scheduling": {      "url": "https://acuity-scheduling.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Acuity Scheduling credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/acuity-scheduling/

On first connect you'll provide your Acuity User ID and API Key (Acuity → Integrations → API). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

Tool	Type	What it does
`acuity_list_appointments`	read	List appointments
`acuity_get_appointment`	read	Get appointment
`acuity_list_appointment_types`	read	List appointment types
`acuity_list_calendars`	read	List calendars
`acuity_availability_dates`	read	Get available dates
`acuity_availability_times`	read	Get available times
`acuity_availability_classes`	read	Get available classes
`acuity_list_clients`	read	List clients
`acuity_list_forms`	read	List intake forms
`acuity_list_products`	read	List products
`acuity_list_orders`	read	List orders
`acuity_list_blocks`	read	List blocked-off times
`acuity_list_labels`	read	List labels
`acuity_get_me`	read	Get account info
`acuity_create_appointment`	write	Create appointment
`acuity_cancel_appointment`	write	Cancel appointment
`acuity_reschedule_appointment`	write	Reschedule appointment
`acuity_create_client`	write	Create client
`acuity_usage_status`	meta	Usage status (free-tier meter)
`acuity_request_feature`	meta	Request a missing feature
`acuity_upgrade`	meta	Upgrade to Pro or Pro+
`acuity_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with acuity_upgrade (it returns a Stripe Checkout link). Cancel any time with acuity_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running acuity_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/acuity-scheduling/README.md at commit 4046075

Tools

acuity_list_appointments

List appointments

List appointments scheduled on the account. For bulk contact/parent lists, use view: contacts to return only id, firstName, lastName, email, phone and datetime, without forms/formsText. Contacts view or an explicit offset returns {appointments, pagination}; follow pagination.nextOffset with identical filters until null. Pages fit below the tool output cap and can contain fewer than max rows. Offsets are connector-managed by fetching a prefix (Acuity has no documented native offset); at 10,000 appointments per filter/date window, narrow minDate/maxDate and restart at 0. Appointments may change between calls; deduplicate by id. Default full view without offset preserves the original array response. Acuity REST: GET /appointments.

ParametersmaxviewemailoffsetmaxDateminDatecanceledlastNamedirectionfirstNamecalendarIDexcludeForms+1 more

acuity_get_appointment

Get appointment

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

Parametersidrequired

acuity_list_appointment_types

List appointment types

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

ParametersincludeDeleted

acuity_list_calendars

List calendars

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

Takes no parameters.

acuity_availability_dates

Get available dates

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

ParametersmonthrequiredtimezonecalendarIDappointmentTypeIDrequired

acuity_availability_times

Get available times

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

ParametersdaterequiredtimezonecalendarIDappointmentTypeIDrequired

acuity_availability_classes

Get available classes

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

ParametersmonthrequiredtimezoneappointmentTypeIDrequiredincludeUnavailable

acuity_list_clients

List clients

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

Parameterssearch

acuity_list_forms

List intake forms

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

Takes no parameters.

acuity_list_products

List products

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

Takes no parameters.

acuity_list_orders

List orders

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

Parametersmaxemail

acuity_list_blocks

List blocked-off times

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

ParametersmaxmaxDateminDatecalendarID

acuity_list_labels

List labels

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

Takes no parameters.

acuity_get_me

Get account info

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

Takes no parameters.

acuity_create_appointment

Create appointment

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.

ParametersadminemailrequirednotesphonefieldsnoEmaildatetimerequiredlastNamerequiredtimezonefirstNamerequiredcalendarIDappointmentTypeIDrequired

acuity_cancel_appointment

Cancel appointment

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

ParametersidrequiredadminnoEmailcancelNote

acuity_reschedule_appointment

Reschedule appointment

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.

ParametersidrequiredadminnoEmaildatetimerequiredcalendarID

acuity_create_client

Create client

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

ParametersemailnotesphonelastNamerequiredfirstNamerequired

Version history

v1.37.3LatestNov 7, 2026
v1.36.3Nov 5, 2026
v1.36.2Nov 5, 2026
v1.36.1Nov 4, 2026
v1.36.0Nov 3, 2026
v1.35.1Nov 3, 2026
v1.34.0Nov 1, 2026
v1.32.0Oct 31, 2026
v1.31.0Oct 31, 2026
v1.30.1Oct 30, 2026
v1.29.0Oct 30, 2026
v1.24.0Oct 26, 2026
v1.21.3Oct 25, 2026
v1.21.0Oct 25, 2026
v1.20.0Oct 24, 2026
v1.17.0Oct 23, 2026
v1.16.4Oct 22, 2026
v1.16.3Oct 21, 2026
v1.11.1Oct 9, 2026
v1.10.0Oct 9, 2026
v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Communication & Collaboration15 toolsNov 8, 2026

Plan	Price	Limit
Free	$0	50 tool calls / month
Pro (per user)	$9/mo or $90/yr (2 months free)	Unlimited*