Mindbody MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Mindbody MCP or direct API to list classes, manage bookings, look up clients, and review memberships through natural language.

Mindbody logoMindbody
Api Key

Mindbody is business management software for fitness, wellness, and beauty teams. It helps studios manage scheduling, clients, payments, memberships, and daily operations.

18 Tools

Try Mindbody now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Mindbody
Try asking
TOOLS

Supported Tools

Every Mindbody action and event your agent gets out of the box.

Add Client to Class

Validate or book a client into a class or waitlist.

Create Client

Create one Mindbody client, or reactivate a matching inactive client when reactivate_inactive_client=true.

Find Clients

Look up privacy-shaped clients by 1-20 exact known client RSSIDs using API Key and Site ID.

Get Appointment Availability

Return actual BookableItems availability ranges for appointment session types.

Get Client Complete Info

Retrieve a complete Mindbody client profile by known client RSSID, including requested services, contracts, memberships, and arrival programs.

List Accessible Sites

List Mindbody sites accessible to the connected API key, or retrieve fuller details by filtering to one site ID.

List Active Session Times

List configured business-hour time slots and booking increments.

List Appointments

List booked staff appointments by client, date, appointment, location, or staff filters.

List Classes

Search scheduled class instances by date, location, program, session type, instructor, or known class IDs.

List Client Purchases

List item-level purchases made by a specific Mindbody client within an optional date range.

List Client Visits

List a client's class and appointment visit history within an optional date range.

List Enrollments

Search scheduled multi-session enrollments such as workshops and events by date and business resource IDs.

List Locations

List physical or online locations configured for the connected Mindbody site.

List Sales

List completed Mindbody sales by date range, sale, or payment method.

List Session Types

List service and session types configured at the connected Mindbody site, including IDs used by schedule and availability searches.

List Staff

List basic staff directory records available to the connected API key, with optional role, activity, and ID filters.

Remove Client From Class

Validate or remove one exact Mindbody class visit.

Search Products

Search the connected site's read-only retail product catalog by text, IDs, categories, location, or online-sale status.

SETUP GUIDE

Connect Mindbody MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["mindbody"],
  mcp: true,
});
Create a session scoped to Mindbody and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List upcoming Mindbody classes for this week",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Mindbody request
SETUP GUIDE

Connect Mindbody API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["mindbody"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Mindbody
3

Run Mindbody tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List upcoming Mindbody classes for this week" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Mindbody tool calls through the session, and print the final answer

Why Use Composio?

AI Native Mindbody Integration

  • Supports both Mindbody MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable class, client, and booking workflows
  • Rich coverage for reading, writing, and querying your Mindbody business data

Managed Auth

  • Secure API key handling without hard-coding Mindbody credentials in your agent code
  • Central place to manage, scope, and revoke Mindbody access
  • Per user and per environment credentials so your test and production setups stay clean

Agent Optimized Design

  • Tools are designed so AI agents can understand Mindbody actions like checking class schedules or finding client records
  • Execution logs show what ran, when it ran, and on whose behalf
  • Errors are easier to inspect, which helps you build more reliable booking and operations agents

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Mindbody
  • Scoped, least privilege access to Mindbody resources
  • Full audit trail of agent actions to support review, operations, and compliance
FRAMEWORKS

Use Mindbody with any AI Agent Framework

Choose a Framework you want to connect Mindbody with

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Mindbody.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Mindbody tool your agent needs.Free to start.

Start building