Skip to main content
Glama

🧘 Mindbody MCP Server

npm version CI License: MIT MCP SDK

A comprehensive Model Context Protocol (MCP) server that provides AI assistants with complete access to the Mindbody API for fitness and wellness studio management. Perfect for yoga studios, pilates studios, gyms, and wellness centers.

✨ Features

  • 50+ Tools covering every aspect of studio operations

  • Complete Class Management - View schedules, book clients, manage waitlists, substitute teachers

  • Client Management - Add/update clients, track visits, memberships, and balances

  • Sales & Commerce - Process payments, sell packages, memberships, and retail products

  • Staff Management - View schedules, manage appointments, track availability

  • Multi-Location Support - Manage multiple studio locations seamlessly

  • High Performance - Built on Bun runtime with intelligent caching

  • Type-Safe - Full TypeScript support with comprehensive types

  • Dual Transport Support - STDIO for local development, SSE for production deployment

Related MCP server: GoHighLevel MCP Server

πŸš€ Quick Start

Installation with npx (Node.js)

# Run directly without installation
npx @vespo92/mindbody-mcp

# Or install globally
npm install -g @vespo92/mindbody-mcp

Installation with bunx (Bun - 4x faster)

# Run directly without installation  
bunx @vespo92/mindbody-mcp

# Or install globally with Bun
bun install -g @vespo92/mindbody-mcp

Install from GitHub

# Using npx
npx github:vespo92/MindbodyMCP

# Using bunx (recommended for performance)
bunx github:vespo92/MindbodyMCP

# Or clone and run locally
git clone https://github.com/vespo92/MindbodyMCP.git
cd MindbodyMCP
bun install # or npm install
bun run start # or npm start

πŸ“‹ Prerequisites

  • Node.js 18+ or Bun 1.0+

  • Mindbody API credentials (API Key, Site ID, Source credentials)

  • Claude Desktop or any MCP-compatible client

βš™οΈ Configuration

1. Get Mindbody API Credentials

  1. Sign up for a Mindbody Developer Account

  2. Create a new app to get your API credentials

  3. Note your Site ID (use -99 for sandbox testing)

2. Set Environment Variables

Create a .env file in your project root:

# Copy the example file
cp .env.example .env

# Edit with your credentials
MINDBODY_API_KEY=your_api_key_here
MINDBODY_SITE_ID=-99  # Your site ID
MINDBODY_SOURCE_NAME=your_source_name
MINDBODY_SOURCE_PASSWORD=your_source_password

# Optional settings
MINDBODY_API_URL=https://api.mindbodyonline.com/public/v6
CACHE_TTL_MINUTES=5
MCP_SERVER_NAME=mindbody-mcp
MCP_SERVER_VERSION=2.0.0

3. Configure Claude Desktop

Add to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mindbody": {
      "command": "bunx",
      "args": ["@vespo92/mindbody-mcp"],
      "env": {
        "MINDBODY_API_KEY": "your_api_key",
        "MINDBODY_SITE_ID": "-99",
        "MINDBODY_SOURCE_NAME": "your_source_name",
        "MINDBODY_SOURCE_PASSWORD": "your_source_password"
      }
    }
  }
}

Or use the GitHub repository directly:

{
  "mcpServers": {
    "mindbody": {
      "command": "bunx",
      "args": ["github:vespo92/MindbodyMCP"],
      "env": {
        "MINDBODY_API_KEY": "your_api_key",
        "MINDBODY_SITE_ID": "-99",
        "MINDBODY_SOURCE_NAME": "your_source_name",
        "MINDBODY_SOURCE_PASSWORD": "your_source_password"
      }
    }
  }
}

πŸ› οΈ Available Tools

The server provides 50+ tools across 7 categories:

πŸ“… Class Management

  • getClasses - View all classes with filters

  • getClassDescriptions - List class types

  • getClassSchedules - View recurring schedules

  • addClientToClass - Book clients into classes

  • removeClientFromClass - Cancel bookings

  • getWaitlistEntries - Manage waitlists

  • substituteClassTeacher - Handle substitutions

πŸ‘₯ Client Management

  • getClients - Search and retrieve clients

  • addClient - Register new clients

  • updateClient - Update client information

  • getClientVisits - View attendance history

  • getClientMemberships - Check active memberships

  • addClientArrival - Check-in clients

  • getClientAccountBalances - View account balances

  • getClientContracts - View contracts

πŸ’° Sales & Commerce

  • getServices - View available services

  • getPackages - List class packages

  • getProducts - Browse retail products

  • getContracts - View membership options

  • checkoutShoppingCart - Process purchases

  • purchaseContract - Sell memberships

🏒 Site & Locations

  • getSites - Get business information

  • getLocations - List all locations

  • getPrograms - View programs offered

  • getResources - Manage resources

  • getSessionTypes - List session types

  • getStaff - View all staff members

  • getTeacherSchedule - Teacher schedules

πŸ“† Appointments

  • getStaffAppointments - View appointments

  • addAppointment - Book appointments

  • updateAppointment - Modify appointments

  • getBookableItems - Find available slots

  • getActiveSessionTimes - Check availability

  • getScheduleItems - View schedules

πŸŽ“ Enrollments

  • getEnrollments - View courses/workshops

  • addClientToEnrollment - Register for courses

  • getClientEnrollments - View client enrollments

πŸ’¬ Example Usage in Claude

Once configured, you can ask Claude:

"Show me today's yoga classes"
"Book Sarah Johnson into the 6pm Vinyasa class"
"Who's on the waitlist for tomorrow's Hot Yoga?"
"Add a new client named Jennifer Wilson"
"What's Michael's attendance this month?"
"Process a 10-class package purchase for Amy"
"Find a substitute for Maria's Thursday class"

πŸ—οΈ Development

Local Development

# Clone the repository
git clone https://github.com/vespo92/MindbodyMCP.git
cd MindbodyMCP

# Install dependencies
bun install  # or npm install

# Run in development mode
bun run dev  # or npm run dev

# Run tests
bun test  # or npm test

# Build for production
bun run build  # or npm run build

Project Structure

MindbodyMCP/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ index.ts           # Main server entry point
β”‚   β”œβ”€β”€ api/               # API client and auth
β”‚   β”œβ”€β”€ tools/             # Tool implementations
β”‚   β”œβ”€β”€ types/             # TypeScript types
β”‚   β”œβ”€β”€ cache/             # Caching layer
β”‚   └── utils/             # Utility functions
β”œβ”€β”€ tests/                 # Test files
β”œβ”€β”€ .github/workflows/     # CI/CD pipelines
└── CLAUDE.md             # Detailed documentation

🌐 SSE Deployment (Production)

The server supports SSE (Server-Sent Events) transport for production deployment, enabling web-based clients and remote access.

Quick Start with SSE

# Start with SSE transport
bun run start:sse

# Or with environment variable
MCP_TRANSPORT=sse bun start

# With custom port
bun run src/index.ts --transport sse --port 8080

Docker Deployment

# Using Docker Compose
docker-compose up -d

# Or manually
docker build -t mindbody-mcp .
docker run -d -p 3000:3000 -e MCP_TRANSPORT=sse mindbody-mcp

Production Configuration

Configure via environment variables:

  • MCP_TRANSPORT=sse - Enable SSE transport

  • MCP_PORT=3000 - Server port

  • MCP_HOST=0.0.0.0 - Server host

  • MCP_CORS_ORIGIN=https://yourdomain.com - CORS configuration

  • MCP_SSL_CERT=/path/to/cert.pem - SSL certificate (optional)

  • MCP_SSL_KEY=/path/to/key.pem - SSL private key (optional)

Endpoints

  • /health - Health check endpoint

  • /info - Server information

  • /sse - SSE event stream for MCP communication

For detailed deployment instructions, see SSE Deployment Guide.

πŸ§ͺ Testing

# Run all tests
bun test

# Test SSE connection
bun run test:sse

# Test specific tool
bun run test:tool

# Run benchmarks
bun run benchmark

# Type checking
bun run typecheck

πŸ“¦ Publishing

The package is available on:

πŸ”’ Security

  • API credentials are stored securely via environment variables

  • OAuth 2.0 authentication with automatic token refresh

  • No credentials are logged or exposed

  • Regular security audits via GitHub Actions

⚑ Performance

  • Bun Runtime: 4x faster startup than Node.js

  • Intelligent Caching: 5-minute cache for dynamic data, 60-minute for static

  • Automatic Retry: Exponential backoff for failed requests

  • Rate Limiting: Respects Mindbody's 2000 requests/hour limit

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/AmazingFeature)

  3. Commit your changes (git commit -m 'Add some AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

πŸ“ž Support

πŸš€ Roadmap

  • Webhook support for real-time updates

  • Advanced reporting and analytics tools

  • Multi-site synchronization

  • AI-powered recommendations

  • Mobile app integration

  • GraphQL API layer


Available Tools

39 tools
addAppointmentC

Book an appointment

Inputs: staffId (required), clientId (required), locationId (required), sessionTypeId (required), +7 more.

addClientB

Add a new client

Inputs: lastName (required), firstName (required), city, email, +11 more.

addClientArrivalB

Check in a client (mark arrival)

Inputs: clientId (required), locationId (required).

addClientToClassC

Book a client into a class

Inputs: classId (required), clientId (required), waitlist, requirePayment.

addClientToEnrollmentC

Register client for course/workshop

Inputs: clientId (required), classScheduleIds (required), enroll, testMode, +4 more.

checkoutShoppingCartC

Process a shopping cart checkout

Inputs: items (required), clientId (required), payments (required), inStore, +3 more.

getActivationCodeC

Get site activation code

Inputs: no named parameters.

getActiveSessionTimesC

Get active session availability times

Inputs: days, endTime, startTime, scheduleType, +1 more.

getBookableItemsC

Get available appointment slots

Inputs: sessionTypeIds (required), endDate, staffIds, startDate, +2 more.

getClassDescriptionsB

Get all class types/descriptions offered

Inputs: no named parameters.

getClassesC

Get all classes with filtering options

Inputs: endDate, staffIds, startDate, locationIds, +1 more.

getClassSchedulesC

Get class schedules (recurring class templates)

Inputs: staffIds, programIds, locationIds, classDescriptionIds.

getClassVisitsA

Get client visits/attendance for a specific class. Returns all clients who booked or attended the class, including sign-in status, late cancellations, and service information.

Inputs: classId (required), lastModifiedDate.

getClientAccountBalancesB

Get client's account balances

Inputs: clientId (required).

getClientContractsB

Get client's contracts/memberships

Inputs: clientId (required).

getClientEnrollmentsC

Get client's enrollments

Inputs: clientId (required).

getClientMembershipsC

Get client's active memberships

Inputs: clientId (required), locationId.

getClientsC

Search and retrieve clients

Inputs: clientIds, isProspect, searchText, lastModifiedDate.

getClientVisitsC

Get client's visit/attendance history

Inputs: clientId (required), endDate, startDate.

getContractsC

Get available contracts/memberships

Inputs: locationId, soldOnline, contractIds.

getEnrollmentsC

Get enrollments (courses, workshops, series)

Inputs: endDate, staffIds, courseIds, startDate, +5 more.

getLocationsB

Get all studio locations

Inputs: no named parameters.

getPackagesC

Get class packages

Inputs: locationId, classScheduleId.

getProductsC

Get retail products

Inputs: productIds, searchText, sellOnline, categoryIds, +1 more.

getProgramsC

Get programs (yoga, pilates, etc.)

Inputs: onlineOnly, scheduleType.

getResourcesC

Get resources (rooms, equipment)

Inputs: locationId, endDateTime, startDateTime, sessionTypeIds.

getScheduleItemsC

Get schedule items/availability

Inputs: endDate, staffIds, startDate, locationIds, +1 more.

getServicesC

Get available services (class packages, memberships)

Inputs: classId, locationId, programIds, sessionTypeIds, +1 more.

getSessionTypesB

Get session types (class types, appointment types)

Inputs: onlineOnly, programIds.

getSitesB

Get site/business information

Inputs: no named parameters.

getStaffB

Get all staff members with optional filters

Inputs: filters, staffIds, locationIds, startDateTime, +1 more.

getStaffAppointmentsC

Get staff appointments

Inputs: staffIds (required), endDate, clientIds, startDate, +2 more.

getTeacherScheduleB

Get a teacher's class schedule for a specified date range

Inputs: teacherName (required), endDate, startDate.

getWaitlistEntriesC

Get waitlist entries for classes

Inputs: classIds, clientIds, classScheduleIds.

purchaseContractC

Purchase a contract/membership

Inputs: clientId (required), startDate (required), contractId (required), locationId, +3 more.

removeClientFromClassB

Cancel a client's class booking

Inputs: classId (required), clientId (required), lateCancel.

substituteClassTeacherB

Substitute a teacher for a class

Inputs: classId (required), originalTeacherId (required), substituteTeacherId (required), substituteTeacherName.

updateAppointmentC

Update an appointment

Inputs: appointmentId (required), notes, staffId, sendEmail, +5 more.

updateClientC

Update client information

Inputs: updates (required), clientId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 39 tools

    Disambiguation3/5

    Many tools have clearly distinct resources, but the scheduling and purchasing domains contain overlapping tools (e.g., getServices, getPackages, getContracts; getBookableItems, getActiveSessionTimes, getScheduleItems). Additionally, getClassVisits and getClientVisits are similar in scope, creating potential confusion.

    Naming Consistency4/5

    Tool names consistently follow a verb_noun pattern (get, add, update, remove, substitute, checkout, purchase) and use camelCase throughout. Minor deviations exist in verb choice for similar actions (e.g., addClientToClass vs. addClient), but the overall structure is predictable and readable.

    Tool Count2/5

    With 39 tools, the server exceeds the 25+ threshold considered excessive, creating a large and potentially overwhelming surface for agents. Even though Mindbody is a broad domain, the number of tools could be consolidated or split into different servers.

    Completeness3/5

    The tool set covers many core workflows: client management, class scheduling, appointments, enrollments, and sales. However, obvious lifecycle gaps exist, such as no delete operations for clients or appointments, no class creation/update, and no cancellation for appointments, which can lead to dead ends.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to directly interact with the entire GoHighLevel CRM via 563+ tools across 44 categories, allowing natural language control for contacts, messaging, opportunities, calendars, and more.
      16 npm
      1
      ISC
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to query and manage Altea Active memberships through natural language, including schedules, spot availability, instructor sessions, bookings, cancellations, and waitlists.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to find gyms and studios, check schedules and prices, start trial classes, and, after OAuth sign-in, view, book, or cancel classes with a membership. Public tools require no account, while member tools enforce each gym's booking rules and never pass payment data to the assistant.
      MIT