getClassesLABSCO SUMMARY
Test against site -99 before you point it at the real studio.
The breadth is the appeal and also the risk: checkout and contract purchase sit on the same connection as the schedule lookup, so an assistant that misreads an instruction can sell a membership. The sandbox site ID exists for exactly this, and the cache means the read-heavy half — schedules, staff, class lists — stays fast once warm.
What it is
An MCP server covering the Mindbody public API for studio operations. It is not a reporting connector: the same server that shows you today's schedule books a client into a class, checks them in, and processes the package they bought. Caching sits in front of the API so repeated schedule reads are cheap.
What you get
- Classes —
getClasseswith filters,getClassDescriptions,getClassSchedules,addClientToClass,removeClientFromClass,getWaitlistEntries,substituteClassTeacher - Clients —
getClients,addClient,updateClient,getClientVisits,getClientMemberships,addClientArrivalfor check-in,getClientAccountBalances,getClientContracts - Sales —
getServices,getPackages,getProducts,getContracts,checkoutShoppingCart,purchaseContract - Sites and staff —
getSites,getLocations,getPrograms,getResources,getSessionTypes,getStaff,getTeacherSchedule, with multi-location support - Appointments —
getStaffAppointments,addAppointment,updateAppointment,getBookableItems,getActiveSessionTimes,getScheduleItems - Enrollments —
getEnrollments,addClientToEnrollment,getClientEnrollments - The README's tool list names 37 tools in six groups (its headline says 50+ across 7), served over stdio locally or SSE for a deployed instance
Requirements
A Mindbody developer account and an app, which gives you four values: MINDBODY_API_KEY, MINDBODY_SITE_ID, MINDBODY_SOURCE_NAME and MINDBODY_SOURCE_PASSWORD. Site ID -99 is the sandbox — start there, because the live equivalent takes real bookings and real payments. Node.js 18+ or Bun 1.0+; run it with npx @vespo92/mindbody-mcp or bunx @vespo92/mindbody-mcp. For a deployed instance set MCP_TRANSPORT=sse with MCP_PORT, MCP_HOST and MCP_CORS_ORIGIN, and optionally MCP_SSL_CERT and MCP_SSL_KEY; /health, /info and /sse are exposed. Package @vespo92/mindbody-mcp, MIT.
Setup effort
One command plus a key — npx @vespo92/mindbody-mcp, then supply credentials
USE CASES
01
Filling a class from the waitlist
Read who is waiting for tomorrow's session and book them in without opening the Mindbody console.
02
Covering a teacher who called in sick
Look at who is free on that schedule and assign the substitute in one step.
03
Answering a question about a client at the front desk
Pull their visit history, active memberships and account balance together while they are standing there.
04
Selling a class package
Find the package, check it out against the client's account, and confirm the purchase landed.
05
Booking a one-to-one session
Find bookable slots for the staff member, then create the appointment.
37 tools
Listed in project docs. Your client may show a different list.
getClassDescriptionsgetClassSchedulesaddClientToClassremoveClientFromClassgetWaitlistEntriessubstituteClassTeachergetClientsaddClientupdateClientgetClientVisitsgetClientMembershipsaddClientArrivalgetClientAccountBalancesgetClientContractsgetServicesgetPackagesgetProductsgetContractscheckoutShoppingCartpurchaseContractgetSitesgetLocationsgetProgramsgetResourcesgetSessionTypesgetStaffgetTeacherSchedulegetStaffAppointmentsaddAppointmentupdateAppointmentgetBookableItemsgetActiveSessionTimesgetScheduleItemsgetEnrollmentsaddClientToEnrollmentgetClientEnrollmentsBEFORE YOU INSTALL
What to know first
Tools you get
37 tools named in the project's documentation.
Requires
- Node.js 18+ or Bun 1.0+
- MINDBODY_API_KEY in your environment
- MINDBODY_SOURCE_PASSWORD in your environment
- MINDBODY_SITE_ID in your environment
- MINDBODY_SOURCE_NAME in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @vespo92/mindbody-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mindbody": {
"command": "bunx",
"args": [
"@vespo92/mindbody-mcp"
],
"env": {
"MINDBODY_API_KEY": "<YOUR_MINDBODY_API_KEY>",
"MINDBODY_SITE_ID": "-99",
"MINDBODY_SOURCE_NAME": "<YOUR_MINDBODY_SOURCE_NAME>",
"MINDBODY_SOURCE_PASSWORD": "<YOUR_MINDBODY_SOURCE_PASSWORD>"
}
}
}
}
