mindbody-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mindbody-mcp show me classes for next Monday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mindbody-mcp
MCP server for Mindbody, the vertical CRM for wellness, fitness, and beauty studios (yoga, gyms, salons, spas, training studios). 5 tools for AI agents to fetch client info, query class schedules, book clients into classes (env-gated), book appointments (env-gated), and complete shopping cart checkout (payment-gated).
As of May 2026, Mindbody does not ship an official MCP server. Multiple community attempts exist but are unofficial and self-hosted. This is the production-quality, install-ready Python rail. Shipped same-day as Mindbody's May 28 2026 Bilt Rewards distribution partnership.
The 5 tools
Tool | Purpose | Gated? |
| Fetch detailed client profile by ID | No, safe |
| Query class schedules within a date range | No, safe |
| Enroll a client into a class | YES, |
| Schedule a wellness or training appointment | YES, |
| Process payment for passes, services, or products | YES, |
Related MCP server: courtreserve-mcp
Install
pip install mindbody-mcpConfigure
export MINDBODY_API_KEY="your-mindbody-developer-api-key"
export MINDBODY_SITE_ID="your-mindbody-site-id-integer" # use -99 for sandbox
export MINDBODY_USER_TOKEN="your-mindbody-staff-user-token" # optional but required for client + write actions
export MINDBODY_ALLOW_BOOKINGS="false" # set to "true" to enable booking writes
export MINDBODY_ALLOW_CHECKOUT="false" # set to "true" to enable payment processing (separate flag for safety)Get an API key in your Mindbody Developer account. The user token is obtained via staff login flow; check the Mindbody Public API V6 docs for details.
Use with Claude Desktop
{
"mcpServers": {
"mindbody": {
"command": "mindbody-mcp",
"env": {
"MINDBODY_API_KEY": "your-mindbody-developer-api-key",
"MINDBODY_SITE_ID": "your-mindbody-site-id-integer",
"MINDBODY_USER_TOKEN": "your-mindbody-staff-user-token",
"MINDBODY_ALLOW_BOOKINGS": "false",
"MINDBODY_ALLOW_CHECKOUT": "false"
}
}
}
}Restart Claude Desktop. The 5 Mindbody tools are now available.
Use case: AI front-desk + AI personal scheduler
Read-only flow (safe, default):
Call
get_client_info(client_id)to load the caller's profileCall
list_classes(start_datetime, end_datetime)to surface available classes
Booking-enabled flow (after setting MINDBODY_ALLOW_BOOKINGS=true):
Call
book_client_to_class(client_id, class_id)to enroll the callerCall
book_appointment(client_id, staff_id, session_type_id, start_datetime)for 1-on-1 sessions
Payment-enabled flow (after setting MINDBODY_ALLOW_CHECKOUT=true):
Call
checkout_shopping_cart(client_id, item_id, item_type, quantity)to process payment
Safety note: two separate flags for write actions and payment
MINDBODY_ALLOW_BOOKINGSgates the two booking writes (class enrollment + appointment scheduling). Bookings create real reservations on the studio's calendar.MINDBODY_ALLOW_CHECKOUTgates the payment action. Checkout actually charges the client's payment method. This is intentionally a SEPARATE flag so studio owners can enable AI agent bookings without also enabling AI agent purchasing. Two-step opt-in keeps real money out of an over-eager agent's reach by default.
Billing note
Since October 1, 2023, Mindbody charges $0.002 per API call in production environments. Operators should cache responses where possible to control billing overhead. This MCP does not cache responses; caching is the operator's responsibility per workflow.
Architecture
Public MIT-licensed wrapper around the Mindbody Public API V6
Async HTTP via
httpxpydantic v2 input validation
Three-header auth:
Api-Key,SiteId, optionalAuthorization(user token)Rate-limit aware (429 returns a clean error)
Write actions gated by env flag
Payment action gated by a SEPARATE env flag
Development
git clone https://github.com/NoBanks/mindbody-mcp.git
cd mindbody-mcp
pip install -e ".[dev]"
pytestLicense
MIT. See LICENSE.
Author
Ryan Hammer (NoBanks). Solo founder + engineer. Built this and 15 other MCP servers as part of a sprint to expose AI agent rails for the products and platforms shipping daily. Built mindbody-mcp specifically as a same-day reply to Mindbody's May 28 2026 Bilt Rewards distribution partnership.
GitHub: @NoBanks
X/Twitter: @livingagentic
Open to AI engineering roles, contract or full-time, remote-only.
Available Tools
5 toolsbook_appointmentA
Schedule a single wellness or training appointment for a client with a specific staff member at a specific time. GATED behind MINDBODY_ALLOW_BOOKINGS. Returns an error if not enabled.
Inputs: client_id (required), staff_id (required), session_type_id (required), start_datetime (required).
book_client_to_classA
Enroll a client into an upcoming studio class. GATED behind MINDBODY_ALLOW_BOOKINGS env var. Returns an error if not enabled. This action results in a real reservation.
Inputs: client_id (required), class_id (required).
checkout_shopping_cartA
Process purchases and complete payment checkout for passes, services, or products. GATED behind MINDBODY_ALLOW_CHECKOUT env var. This action TAKES PAYMENT from the client. Returns an error if not enabled.
Inputs: client_id (required), item_id (required), item_type (required), quantity.
get_client_infoB
Fetch detailed profile information for a Mindbody client. Used by AI front-desk agents to ground responses in customer history.
Inputs: client_id (required).
list_classesA
Query class schedules and active class lists within a date range. Used by AI scheduling agents to surface available classes to a caller.
Inputs: start_datetime, end_datetime.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct action: booking an appointment, booking a class, processing payment, fetching client info, and listing classes. No functional overlap.
All tools use consistent snake_case verb_noun pattern (book_appointment, book_client_to_class, checkout_shopping_cart, get_client_info, list_classes).
5 tools is well within the ideal 3-15 range and covers core scheduling and client operations without feeling sparse or bloated.
Covers basic booking and client info but lacks cancel/modify appointments, staff listing, or class search beyond listing. Notable gaps for full lifecycle management.
Maintenance
Related MCP Connectors
Mindbody MCP server for ChatGPT, Claude and any AI agent: list classes, get class roster, search clients, get client visits, list client contracts, book client into class, cancel client booking and add client in your own Mindbody account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Mindbody yourself; Cotlet does not store your password and you need no Mindbody API key. About the official Mindbody API: Yes. Mindbody has a Public API v6, but it is for approved developers, each studio owner must activate access for their site, and it has no official MCP server (checked 5 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/mindbody-api-mcp-server
Stop manually creating generic reports that don't match your gym! Ask your AI about your studio's sales, classes and clients. Mindbody MCP server for Claude and ChatGPT. Connect your studio once, then ask about sales, classes, clients and memberships. Not affiliated with Mindbody.
Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for Housecall Pro, providing 5 tools for AI agents to register customers, schedule jobs, create estimates, log leads, and generate invoices (env-gated).5MIT
- AlicenseAqualityDmaintenanceMCP server for CourtReserve racquet-sports club management, enabling AI clients to manage members, reservations, events, and transactions via natural language.291MIT
- AlicenseNot gradedqualityCmaintenanceMCP server wrapping Monday.com GraphQL API to enable AI agents to interact with Monday.com boards, items, and workspaces through natural language or tool calls.296 npmMIT

@gravv/mcpofficial
AlicenseAqualityBmaintenanceMCP server for the Gravv payments API that lets AI assistants onboard customers, run KYC, open accounts, move money, issue cards, and exchange currency, with built-in documentation search and safety confirmations for money-moving operations.28 npmMIT