# Mindbody MCP by usefulapi

> Mindbody MCP by usefulapi is an MCP server. Read Mindbody classes, schedules, clients, staff and sales; book clients and appointments. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/mindbody/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/mindbody
- **MCP Registry name:** io.usefulapi/mindbody
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mindbody https://mindbody.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mindbody.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mindbody": {
      "url": "https://mindbody.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mindbody": {
      "type": "http",
      "url": "https://mindbody.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mindbody": {
      "serverUrl": "https://mindbody.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mindbody": {
      "type": "http",
      "url": "https://mindbody.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `mindbody_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.
- `mindbody_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.
- `mindbody_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.
- `mindbody_list_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.
- `mindbody_list_class_schedules`: List recurring class schedules (the templates that generate class occurrences) — days, times, teacher, location and date span. Mindbody: GET /class/classschedules.
- `mindbody_get_class_visits`: Get one class with its visits — the roster of clients booked into it, with sign-in / late-cancel status. Mindbody: GET /class/classvisits.
- `mindbody_list_bookable_items`: 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.
- `mindbody_list_staff_appointments`: List booked appointments in a date range, by staff member, client or appointment id — the appointment book. Mindbody: GET /appointment/staffappointments.
- `mindbody_list_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.
- `mindbody_list_client_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.
- `mindbody_list_client_memberships`: List a client's active memberships (auto-renewing pricing options) with remaining counts and expiry. Mindbody: GET /client/activeclientmemberships.
- `mindbody_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.
- `mindbody_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.
- `mindbody_list_services`: 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.
- `mindbody_list_sales`: List completed sales at the site in a date/time range — purchased items, payments and client. Read only. Mindbody: GET /sale/sales.
- `mindbody_add_client_to_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.
- `mindbody_add_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.
- `mindbody_update_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/updateappoint
- `mindbody_add_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.
- `mindbody_update_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.

## FAQ

### How do I add Mindbody MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http mindbody https://mindbody.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/mindbody-mcp-by-usefulapi
