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.

destructive

Argument	Type	Description
test	boolean	When true, Mindbody validates the request but commits nothing. Use it to dry-run a write.
notes	string	General notes for the appointment.
duration	integer	Override the default duration, in minutes.
staff_id*	integer	The staff member delivering the appointment.
client_id*	string	The client's ID (RSSID — a string, as configured by the business; see mindbody_list_clients).
send_email	boolean	Send the site's automatic email.
is_waitlist	boolean	Add to the appointment waiting list instead.
location_id*	integer	The location id.
resource_ids	array	Resource (room/equipment) ids to attach.
apply_payment	boolean	Apply a pricing option already on the client's account (Mindbody default: true).
end_date_time	string	End, ISO 8601. Default: start + the default duration.
session_type_id*	integer	The session type id.
staff_requested	boolean	The client asked for this staff member specifically.
start_date_time*	string	Start, ISO 8601 (e.g. 2026-10-01T14:00:00).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "client_id",
    "location_id",
    "session_type_id",
    "staff_id",
    "start_date_time"
  ],
  "properties": {
    "test": {
      "type": "boolean",
      "description": "When true, Mindbody validates the request but commits nothing. Use it to dry-run a write."
    },
    "notes": {
      "type": "string",
      "description": "General notes for the appointment."
    },
    "duration": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Override the default duration, in minutes."
    },
    "staff_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The staff member delivering the appointment."
    },
    "client_id": {
      "type": "string",
      "description": "The client's ID (RSSID — a string, as configured by the business; see mindbody_list_clients)."
    },
    "send_email": {
      "type": "boolean",
      "description": "Send the site's automatic email."
    },
    "is_waitlist": {
      "type": "boolean",
      "description": "Add to the appointment waiting list instead."
    },
    "location_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The location id."
    },
    "resource_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991
      },
      "description": "Resource (room/equipment) ids to attach."
    },
    "apply_payment": {
      "type": "boolean",
      "description": "Apply a pricing option already on the client's account (Mindbody default: true)."
    },
    "end_date_time": {
      "type": "string",
      "description": "End, ISO 8601. Default: start + the default duration."
    },
    "session_type_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The session type id."
    },
    "staff_requested": {
      "type": "boolean",
      "description": "The client asked for this staff member specifically."
    },
    "start_date_time": {
      "type": "string",
      "description": "Start, ISO 8601 (e.g. 2026-10-01T14:00:00)."
    }
  }
}

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.

destructive

Argument	Type	Description
city	string	City.
test	boolean	When true, Mindbody validates the request but commits nothing. Use it to dry-run a write.
email	string	Email address.
state	string	State / region.
gender	string	Gender, as configured at the site (see the site's genders).
country	string	Country.
last_name*	string	Last name.
birth_date	string	Date of birth, ISO 8601 (e.g. 1990-04-12).
first_name*	string	First name.

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.

destructive

Argument	Type	Description
test	boolean	When true, Mindbody validates the request but commits nothing. Use it to dry-run a write.
class_id*	integer	The class id (from mindbody_list_classes).
waitlist	boolean	Add to the class waiting list instead of the class.
client_id*	string	The client's ID (RSSID — a string, as configured by the business; see mindbody_list_clients).
send_email	boolean	Send the site's booking confirmation email.
require_payment	boolean	Require an active, usable pricing option on the client's account.
client_service_id	integer	The id of the pricing option already on the client's account to use for this booking.

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.

read-only

Argument	Type	Description
class_id*	integer	The class id (from mindbody_list_classes).
last_modified_date	string	Only visits modified on or after this date — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "class_id"
  ],
  "properties": {
    "class_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The class id (from mindbody_list_classes)."
    },
    "last_modified_date": {
      "type": "string",
      "description": "Only visits modified on or after this date — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
class_id	integer	Balance relative to this class/event id.
client_ids*	array	The client ids to get balances for.
balance_date	string	Balance as of this date (default today) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "client_ids"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page size (request.limit), 1-200. Mindbody defaults to 100."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults."
    },
    "class_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Balance relative to this class/event id."
    },
    "client_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "The client ids to get balances for."
    },
    "balance_date": {
      "type": "string",
      "description": "Balance as of this date (default today) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
end_date	string	End of the range (default start_date) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
staff_ids	array	Only these staff ids (omit for all staff).
start_date	string	Start of the range (default today) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
location_ids	array	Only at these location ids.
appointment_id	integer	Exclude this existing appointment (useful when rescheduling).
session_type_ids*	array	Session type ids to find availability for (see mindbody_list_session_types).

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
end_date	string	Only schedules active on or before this day (default start_date) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
staff_ids	array	Only taught by these staff ids.
start_date	string	Only schedules active on or after this day (default today) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
program_ids	array	Only in these program ids.
location_ids	array	Only at these location ids.
session_type_ids	array	Only these session type ids.

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
class_ids	array	Only these class ids.
client_id	string	View the list as this client (may reveal client-specific pricing).
staff_ids	array	Only taught by these staff ids.
program_ids	array	Only in these program ids.
location_ids	array	Only at these location ids.
end_date_time	string	End of the range (default today; compares dates, not times) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
start_date_time

mindbody_list_client_memberships

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

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
client_id*	string	The client's ID (RSSID — a string, as configured by the business; see mindbody_list_clients).
location_id	integer	Only memberships usable at this location (not with cross_regional_lookup).
cross_regional_lookup	boolean	Search up to ten associated sites in the region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "client_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page size (request.limit), 1-200. Mindbody defaults to 100."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults."
    },
    "client_id": {
      "type": "string",
      "description": "The client's ID (RSSID — a string, as configured by the business; see mindbody_list_clients)."
    },
    "location_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Only memberships usable at this location (not with cross_regional_lookup)."
    },
    "cross_regional_lookup": {
      "type": "boolean",
      "description": "Search up to ten associated sites in the region."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
order	string	Sort by date: desc = newest first.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
end_date	string	Only visits on or before this date (default today) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
client_id*	string	The client's ID (RSSID — a string, as configured by the business; see mindbody_list_clients).
start_date	string	Only visits on or after this date — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
unpaids_only	boolean	Only visits not yet paid for.
cross_regional_lookup	boolean	Include visits at every site in the region.

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
client_ids	array	Only these client ids (max 20).
is_prospect	boolean	true = only prospects; false = only non-prospects.
search_text	string	Match against first name, last name and email.
include_inactive	boolean	Include inactive clients (default false).
last_modified_date	string	Only clients modified on or after this date — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page size (request.limit), 1-200. Mindbody defaults to 100."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults."
    },
    "client_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "description": "Only these client ids (max 20)."
    },
    "is_prospect": {
      "type": "boolean",
      "description": "true = only prospects; false = only non-prospects."
    },
    "search_text": {
      "type": "string",
      "description": "Match against first name, last name and email."
    },
    "include_inactive": {
      "type": "boolean",
      "description": "Include inactive clients (default false)."
    },
    "last_modified_date": {
      "type": "string",
      "description": "Only clients modified on or after this date — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page size (request.limit), 1-200. Mindbody defaults to 100."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
sale_id	integer	Only this sale id.
payment_method_id	integer	Only sales paid with this payment method id.
end_sale_date_time	string	Only sales before this date/time — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
start_sale_date_time	string	Only sales after this date/time — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page size (request.limit), 1-200. Mindbody defaults to 100."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults."
    },
    "sale_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Only this sale id."
    },
    "payment_method_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Only sales paid with this payment method id."
    },
    "end_sale_date_time": {
      "type": "string",
      "description": "Only sales before this date/time — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00."
    },
    "start_sale_date_time": {
      "type": "string",
      "description": "Only sales after this date/time — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
class_id	integer	Only pricing options usable for this class id.
staff_id	integer	Show this staff member's per-staff pricing, if the site uses it.
location_id	integer	Compute TaxRate/TaxIncluded for this location (does not filter).
program_ids	array	Only pricing options in these program ids.
sell_online	boolean	Only pricing options sold online.
service_ids	array	Only these pricing option ids.
session_type_ids

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
online_only	boolean	Only session types bookable online.
program_ids	array	Only session types in these program ids.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page size (request.limit), 1-200. Mindbody defaults to 100."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults."
    },
    "online_only": {
      "type": "boolean",
      "description": "Only session types bookable online."
    },
    "program_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991
      },
      "description": "Only session types in these program ids."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
site_ids	array	Only these site ids (returns more detail per site).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Page size (request.limit), 1-200. Mindbody defaults to 100."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults."
    },
    "site_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991
      },
      "description": "Only these site ids (returns more detail per site)."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
filters	array	Filters to apply.
staff_ids	array	Only these staff ids.
location_id	integer	Only staff available at this location (needs session_type_id and start_date_time).
session_type_id	integer	Only staff available for this session type (needs location_id and start_date_time).
start_date_time	string	Only staff available at this time (needs session_type_id and location_id) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.

Input schema (JSON)

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.

read-only

Argument	Type	Description
limit	integer	Page size (request.limit), 1-200. Mindbody defaults to 100.
offset	integer	Page offset (request.offset). Mindbody defaults to 0. See PaginationResponse.TotalResults.
end_date	string	End of the range (default start_date) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
client_id	string	Only this client's appointments.
staff_ids	array	Only these staff ids (omit for all staff).
start_date	string	Start of the range (default today) — ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00.
location_ids	array	Only at these location ids.
appointment_ids	array	Only these appointment ids.

Input schema (JSON)

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/updateappointment.

destructive

Argument	Type	Description
test	boolean	When true, Mindbody validates the request but commits nothing. Use it to dry-run a write.
notes	string	Replace the appointment notes.
execute	string	A status action to apply.
staff_id	integer	Move to this staff member.
send_email	boolean	Send the site's automatic email.
end_date_time	string	New end, ISO 8601.
appointment_id*	integer	The appointment id (from mindbody_list_staff_appointments).
session_type_id	integer

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.

destructive

Argument	Type	Description
city	string	City.
test	boolean	When true, Mindbody validates the request but commits nothing. Use it to dry-run a write.
email	string	Email address.
state	string	State / region.
gender	string	Gender, as configured at the site (see the site's genders).
country	string	Country.
client_id*	string	The client's ID (RSSID — a string, as configured by the business; see mindbody_list_clients).
last_name	string	Last name.
birth_date	string

Mindbody MCP by usefulapi

Try it

mindbody_add_appointment Destructive

Mindbody MCP by usefulapi

Try it

mindbody_add_appointment Destructive

Tools (20)