Mindbody MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.2Updated Nov 14, 2026

Read Mindbody classes, schedules, clients, staff and sales; book clients and appointments.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Hosted Mindbody connector that lets an assistant read classes, schedules, clients, staff and sales, and book clients into classes or appointments.

What you can do
  • List sites, locations, session types, class occurrences, recurring schedules and class rosters
  • Search clients and read their visits, memberships and account balances
  • List staff, bookable appointment slots, booked appointments, pricing options and completed sales
  • Book a client into a class or waitlist, and book an appointment
  • Create client records and update client or appointment details, with a test-only validation mode
  • Check monthly usage, request a feature, upgrade or cancel the paid plan
When to use it
Useful for studios, gyms and clinics on Mindbody whose staff want to ask questions about schedules, class fill rates, rosters, client balances and sales, or have an assistant handle routine bookings and client record updates without opening the Mindbody back office.
Requirements
Remote MCP endpoint added by URL only; sign-in is via OAuth, and the login page asks for Mindbody credentials. On first connect you supply a Mindbody API key and site ID, plus an optional staff login for staff-level tools. A free plan allows 50 tool calls per month; paid plans are billed through a Stripe checkout link.
Before you install
Write tools change real Mindbody data: bookings, new clients, appointment edits and status changes, and client updates that by default also propagate to the client's profiles at other sites in the region. Cancellation of appointments is deliberately not offered because a late cancel can charge the client. Mindbody API key, site ID and staff credentials are stored per user on the provider's servers. Paid plans cost money and are non-refundable for the current period.

Installation

In SourceWeft

  1. Open Mindbody MCP by usefulapi in the dashboard and add it to a workspace.
  2. 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%2Fmindbody/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": {
    "mindbody-by-usefulapi": {
      "type": "http",
      "url": "https://mindbody.usefulapi.io/mcp"
    }
  }
}

README

Mindbody MCP by usefulapi

Use Mindbody from Claude, Cursor, or any MCP client — read classes, schedules, clients, staff, services and sales, and add clients to classes, book appointments and manage clients. Hosted, no local install: connect with your own Mindbody credentials.

Live endpoint: https://mindbody.usefulapi.io/mcp · Homepage: https://usefulapi.io/mindbody

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://mindbody.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http mindbody https://mindbody.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": {    "mindbody": {      "url": "https://mindbody.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 Mindbody credentials.

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

On first connect you'll provide your Mindbody API key and site ID, plus an optional staff login for staff-level tools. They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
mindbody_list_sitesreadList sites
mindbody_list_locationsreadList locations
mindbody_list_session_typesreadList session types
mindbody_list_classesreadList scheduled classes
mindbody_list_class_schedulesreadList class schedules
mindbody_get_class_visitsreadGet a class's visits (roster)
mindbody_list_bookable_itemsreadFind bookable appointment slots
mindbody_list_staff_appointmentsreadList appointments
mindbody_list_clientsreadSearch clients
mindbody_list_client_visitsreadList a client's visits
mindbody_list_client_membershipsreadList a client's active memberships
mindbody_get_client_account_balancesreadGet client account balances
mindbody_list_staffreadList staff
mindbody_list_servicesreadList pricing options
mindbody_list_salesreadList sales
mindbody_add_client_to_classwriteBook a client into a class
mindbody_add_appointmentwriteBook an appointment
mindbody_update_appointmentwriteUpdate an appointment
mindbody_add_clientwriteAdd a client
mindbody_update_clientwriteUpdate a client
mindbody_usage_statusmetaUsage status (free-tier meter)
mindbody_request_featuremetaRequest a missing feature
mindbody_upgrademetaUpgrade to Pro or Pro+
mindbody_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run mindbody_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with mindbody_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with mindbody_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Mindbody.

Source: servers/mindbody/README.md at commit f22f848

Tools

20

mindbody_list_sites

List sites

List the Mindbody sites (businesses) your developer account can access, or details for specific site ids. A cheap way to confirm the API key works. Mindbody: GET /site/sites.

Parameterslimitoffsetsite_ids

mindbody_list_locations

List locations

List the business's locations (studios / branches) with address, phone and amenities. Location ids are needed to book appointments. Mindbody: GET /site/locations.

Parameterslimitoffset

mindbody_list_session_types

List session types

List the session types (the bookable kinds of class or appointment, e.g. '60-min massage') used at the site. Session type ids drive appointment availability and booking. Mindbody: GET /site/sessiontypes.

Parameterslimitoffsetonline_onlyprogram_ids

mindbody_list_classes

List scheduled classes

List scheduled class occurrences in a date range — time, class description, teacher, location, capacity, booked/waitlist counts and cancellation status. Mindbody: GET /class/classes.

Parameterslimitoffsetclass_idsclient_idstaff_idsprogram_idslocation_idsend_date_timestart_date_timesession_type_idsclass_schedule_idslast_modified_date+2 more

mindbody_list_class_schedules

List class schedules

List recurring class schedules (the templates that generate class occurrences) — days, times, teacher, location and date span. Mindbody: GET /class/classschedules.

Parameterslimitoffsetend_datestaff_idsstart_dateprogram_idslocation_idssession_type_idsclass_schedule_ids

mindbody_get_class_visits

Get a class's visits (roster)

Get one class with its visits — the roster of clients booked into it, with sign-in / late-cancel status. Mindbody: GET /class/classvisits.

Parametersclass_idrequiredlast_modified_date

mindbody_list_bookable_items

Find bookable appointment slots

Find appointment availability — which staff can deliver the given session types, where, and in which time windows. Use before mindbody_add_appointment. Mindbody: GET /appointment/bookableitems.

Parameterslimitoffsetend_datestaff_idsstart_datelocation_idsappointment_idsession_type_idsrequiredignore_default_session_lengthinclude_resource_availability

mindbody_list_staff_appointments

List appointments

List booked appointments in a date range, by staff member, client or appointment id — the appointment book. Mindbody: GET /appointment/staffappointments.

Parameterslimitoffsetend_dateclient_idstaff_idsstart_datelocation_idsappointment_ids

mindbody_list_clients

Search clients

Search or fetch client records by name/email text or by client ids (max 20 ids) — contact details, status, alerts, home location. Requires a staff user token. Mindbody: GET /client/clients.

Parameterslimitoffsetclient_idsis_prospectsearch_textinclude_inactivelast_modified_date

mindbody_list_client_visits

List a client's visits

List a client's past and scheduled visits (class and appointment attendance) in a date range, optionally only unpaid ones. Mindbody: GET /client/clientvisits.

Parameterslimitorderoffsetend_dateclient_idrequiredstart_dateunpaids_onlycross_regional_lookup

mindbody_list_client_memberships

List a client's active memberships

List a client's active memberships (auto-renewing pricing options) with remaining counts and expiry. Mindbody: GET /client/activeclientmemberships.

Parameterslimitoffsetclient_idrequiredlocation_idcross_regional_lookup

mindbody_get_client_account_balances

Get client account balances

Get the account balance for one or more clients (what they owe or hold in credit), optionally as of a date. Mindbody: GET /client/clientaccountbalances.

Parameterslimitoffsetclass_idclient_idsrequiredbalance_date

mindbody_list_staff

List staff

List staff members (instructors, practitioners). Filter by role, or find who is available for a session type at a location and time (session_type_id + location_id + start_date_time together). Without a staff token only public fields return. Mindbody: GET /staff/staff.

Parameterslimitoffsetfiltersstaff_idslocation_idsession_type_idstart_date_time

mindbody_list_services

List pricing options

List the pricing options (services — class packs, drop-ins, intro offers) for sale at the site, with price, online price, count and expiry. Read only. Mindbody: GET /sale/services.

Parameterslimitoffsetclass_idstaff_idlocation_idprogram_idssell_onlineservice_idssession_type_idsclass_schedule_idinclude_discontinuedhide_related_programs

mindbody_list_sales

List sales

List completed sales at the site in a date/time range — purchased items, payments and client. Read only. Mindbody: GET /sale/sales.

Parameterslimitoffsetsale_idpayment_method_idend_sale_date_timestart_sale_date_time

mindbody_add_client_to_class

Book a client into a class

Book a client into a class (or onto its waiting list). Does not take payment: by default no pricing option is required; set require_payment to insist the client has a usable one on account. Undo from the Mindbody front desk. Pass test: true to validate only. Mindbody: POST /class/addclienttoclass.

Parameterstestclass_idrequiredwaitlistclient_idrequiredsend_emailrequire_paymentclient_service_id

mindbody_add_appointment

Book an appointment

Book an appointment for a client with a staff member at a location. Find a slot first with mindbody_list_bookable_items. No card is charged; apply_payment (Mindbody's default is true) only applies a pricing option already on the client's account. Pass test: true to validate only. Requires a staff user token. Mindbody: POST /appointment/addappointment.

Parameterstestnotesdurationstaff_idrequiredclient_idrequiredsend_emailis_waitlistlocation_idrequiredresource_idsapply_paymentend_date_timesession_type_idrequired+2 more

mindbody_update_appointment

Update an appointment

Reschedule or edit an appointment (start/end time, staff, session type, notes — the only fields Mindbody lets you change) and/or move it through its status: confirm, unconfirm, arrive, unarrive, complete. Cancel and late-cancel are deliberately not offered (a late cancel can charge the client). Pass test: true to validate only. Requires a staff user token. Mindbody: POST /appointment/updateappointment.

Parameterstestnotesexecutestaff_idsend_emailend_date_timeappointment_idrequiredsession_type_idstart_date_time

mindbody_add_client

Add a client

Create a new client record (first and last name required; the site may require more — Mindbody reports which). No card or billing data is accepted. Pass test: true to validate only. Mindbody: POST /client/addclient.

Parameterscitytestemailstategendercountrylast_namerequiredbirth_datefirst_namerequiredhome_phonework_phoneis_prospect+9 more

mindbody_update_client

Update a client

Update fields on an existing client record — only the fields you pass change. No card or billing data is accepted. cross_regional_update (Mindbody default: true) also updates the client's profiles at the region's other sites. Pass test: true to validate only. Mindbody: POST /client/updateclient.

Parameterscitytestemailstategendercountryclient_idrequiredlast_namebirth_datefirst_namehome_phonework_phone+11 more

Version history

26
  1. v1.39.2LatestNov 14, 2026
  2. v1.39.1Nov 13, 2026
  3. v1.38.0Nov 12, 2026
  4. v1.37.3Nov 11, 2026
  5. v1.36.5Nov 8, 2026
  6. v1.36.4Nov 7, 2026
  7. v1.35.3Nov 5, 2026
  8. v1.35.2Nov 5, 2026
  9. v1.35.1Nov 4, 2026
  10. v1.35.0Nov 3, 2026
  11. v1.34.1Nov 3, 2026
  12. v1.33.0Nov 1, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.0Oct 31, 2026
  15. v1.29.2Oct 30, 2026
  16. v1.29.0Oct 30, 2026
  17. v1.24.0Oct 26, 2026
  18. v1.21.3Oct 25, 2026
  19. v1.21.0Oct 25, 2026
  20. v1.20.0Oct 24, 2026
  21. v1.17.0Oct 23, 2026
  22. v1.16.4Oct 22, 2026
  23. v1.16.3Oct 21, 2026
  24. v1.11.1Oct 9, 2026
  25. v1.10.0Oct 9, 2026
  26. v1.0.0Sep 29, 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

Other Usefulapi integrations