@striderlabs/mcp-mindbody

MCP (Model Context Protocol) connector for the Mindbody fitness booking platform. Uses Playwright browser automation to interact with Mindbody's web interface.

Tools

| Tool | Description | |------|-------------| | search_classes | Find fitness classes by location, type, and date | | get_schedule | Get a studio's full class schedule by site ID | | book_class | Reserve a spot in a class (requires credentials) | | cancel_booking | Cancel an existing class reservation (requires credentials) | | get_bookings | List all upcoming bookings for the authenticated user | | search_studios | Find Mindbody-listed studios near a location | | get_memberships | View active membership status and remaining visits | | get_appointments | View upcoming personal training/wellness appointments |

Installation

npm install -g @striderlabs/mcp-mindbody

# Install Playwright Chromium browser
npx playwright install chromium

Authentication

Tools that require login (book_class, cancel_booking, get_bookings, get_memberships, get_appointments) need your Mindbody credentials.

Option 1: Environment Variables (recommended)

export MINDBODY_USERNAME="[email protected]"
export MINDBODY_PASSWORD="yourpassword"
export MINDBODY_SITE_ID="12345"  # optional default site

Option 2: Credentials File

Create ~/.config/mcp-mindbody/credentials.json:

{
  "username": "[email protected]",
  "password": "yourpassword",
  "siteId": "12345"
}

The file is created with mode 0600 (owner read-only).

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mindbody": {
      "command": "mcp-mindbody",
      "env": {
        "MINDBODY_USERNAME": "[email protected]",
        "MINDBODY_PASSWORD": "yourpassword"
      }
    }
  }
}

Example Prompts

• "Find yoga classes near Brooklyn tomorrow"
• "What's the schedule for Mindbody site 12345 this week?"
• "Book class ID 98765 at site 12345 for me"
• "Show me my upcoming fitness class bookings"
• "Cancel booking 54321"
• "Find CrossFit gyms near 10001"
• "What memberships do I have active?"
• "Show my upcoming personal training appointments"

Development

# Install dependencies
npm install

# Build
npm run build

# Run directly
node dist/index.js

Notes

• Playwright launches a headless Chromium browser for each tool call and closes it after.
• Stealth headers and human-like input delays are used to reduce bot detection risk.
• Mindbody's web UI may change; if scraping breaks, open an issue.
• This connector is not affiliated with Mindbody Inc.

License

MIT