Mindbody MCP server Let your AI agent keep your Mindbody classes full.

ToolWhat it doesAccess

• list_classes Scheduled classes in a date range with time, teacher, booked count and capacity. read

  Reads the class schedule for the dates you give, in start time order. Each class has a class_id for get_class_roster and book_client_into_class, the class name, teacher, start and end time, how many are booked and the maximum. A class that was cancelled is marked cancelled. Dates are read in the studio's time zone. The login needs the staff permission to view the schedule.

  MCP callmindbody_read → list_classes

  REST endpointGET https://cotlet.dev/api/v1/mindbody/classes

  Parameters

  Parameters: list_classes

  Name	Type	Description
  start_date date required	date	First day to list.
  end_date date	date	Last day to list. Default: the same day as start_date.
  teacher string	string	Only classes of this teacher, by name.

  Example input

  {
    "start_date": "2026-10-01"
  }

  Example response

  {
    "classes": [
      {
        "class_id": "c_48121",
        "name": "Morning Vinyasa",
        "teacher": "Dana Reyes",
        "starts_at": "2026-11-10T07:00:00",
        "ends_at": "2026-11-10T08:00:00",
        "booked": 18,
        "capacity": 20,
        "status": "scheduled"
      },
      {
        "class_id": "c_48122",
        "name": "Lunch Pilates",
        "teacher": "Sam Okafor",
        "starts_at": "2026-11-10T12:15:00",
        "ends_at": "2026-11-10T13:00:00",
        "booked": 12,
        "capacity": 14,
        "status": "scheduled"
      }
    ]
  }

• get_class_roster Clients booked into one class, and its waitlist. read

  Returns the people on the roster of one class and, below them, the waitlist in the order clients joined it. Each person has a client_id and the booking_id you pass to cancel_client_booking. The count of the roster matches booked in list_classes. The waitlist is empty when the class has no waitlist or it is not full.

  MCP callmindbody_read → get_class_roster

  REST endpointGET https://cotlet.dev/api/v1/mindbody/class/{class_id}/roster

  Parameters

  Parameters: get_class_roster

  Name	Type	Description
  class_id string required	string	Class ID from list_classes.

  Example input

  {
    "class_id": "class_8c41d2"
  }

  Example response

  {
    "class_id": "c_48121",
    "name": "Morning Vinyasa",
    "roster": [
      {
        "client_id": "100234",
        "name": "Ana Lopez",
        "booking_id": "b_90311"
      },
      {
        "client_id": "100871",
        "name": "Tom Becker",
        "booking_id": "b_90314"
      }
    ],
    "waitlist": [
      {
        "client_id": "101552",
        "name": "Maria Silva"
      }
    ]
  }

ToolWhat it doesAccess

• search_clients Find clients by name, email or phone. read

  Searches the studio's clients and returns up to 25 matches with client_id, name, email and membership status. Use the client_id in the other client tools. An empty result means no client matches, so it is the check to run before add_client. The login needs the staff permission to view client info.

  MCP callmindbody_read → search_clients

  REST endpointGET https://cotlet.dev/api/v1/mindbody/clients/search

  Parameters

  Parameters: search_clients

  Name	Type	Description
  query string required	string	Name, email address or phone number.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "clients": [
      {
        "client_id": "100234",
        "name": "Ana Lopez",
        "email": "ana@example.com",
        "membership_status": "Active"
      }
    ]
  }

• get_client One client's Client Info: contact details, birthday, membership status and last and next visit. read

  Returns what the Client Info screen shows in its Account section: contact details, birthday, client ID, the membership status (for example Active, Expired, Terminated or Suspended), the memberships with their end dates and sessions left, and the date of the last and the next visit. Read only.

  MCP callmindbody_read → get_client

  REST endpointGET https://cotlet.dev/api/v1/mindbody/clients/{client_id}

  Parameters

  Parameters: get_client

  Name	Type	Description
  client_id string required	string	Client ID from search_clients.

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "100234",
    "name": "Ana Lopez",
    "email": "ana@example.com",
    "birthday": "1990-04-12",
    "membership_status": "Active",
    "memberships": [
      {
        "name": "Unlimited Monthly",
        "ends_on": "2026-12-31",
        "sessions_left": null
      }
    ],
    "last_visit": "2026-10-02",
    "next_visit": "2026-11-11"
  }

• list_client_visits A client's past visits, newest first. read

  Returns the visits on the client's Visits screen, newest first, with the class or appointment, the date and the visit status. How far back it goes follows the studio's Client History Windows setting unless you pass a start date. Use it to see how often someone comes.

  MCP callmindbody_read → list_client_visits

  REST endpointGET https://cotlet.dev/api/v1/mindbody/client-visits

  Parameters

  Parameters: list_client_visits

  Name	Type	Description
  client_id string required	string	Client ID from search_clients.
  since date	date	Only visits on or after this date.

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "100234",
    "visits": [
      {
        "date": "2026-10-02",
        "name": "Morning Vinyasa",
        "status": "signed in"
      },
      {
        "date": "2026-09-29",
        "name": "Lunch Pilates",
        "status": "signed in"
      }
    ]
  }

• list_client_contracts A client's contracts with status, end date and autopay state. read

  Returns the contracts on the client's account with the contract name, status, end date, and the state of the autopay as the Autopay Schedule screen shows it. A month-to-month contract has no end date and runs until it is terminated. A contract paused by a declined autopay says so. Use contract_id with terminate_client_contract.

  MCP callmindbody_read → list_client_contracts

  REST endpointGET https://cotlet.dev/api/v1/mindbody/client-contracts

  Parameters

  Parameters: list_client_contracts

  Name	Type	Description
  client_id string required	string	Client ID from search_clients.

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "100234",
    "contracts": [
      {
        "contract_id": "ct_5521",
        "name": "Unlimited Monthly",
        "status": "Active",
        "ends_on": null,
        "autopay": "next payment 2026-12-01"
      }
    ]
  }

• add_client Create a new client. writeasks first

  Adds a client with the name and email you give and returns the new client_id. The studio's welcome email goes out only if the welcome email is set to send by default or you pass send_welcome_email as true, and then it reaches the client. It needs the staff permission Add Client. Run search_clients first, so you do not create a duplicate. By default you confirm each call; you can switch that off for this tool.

  MCP callmindbody_write → add_client

  REST endpointPOST https://cotlet.dev/api/v1/mindbody/clients

  Parameters

  Parameters: add_client

  Name	Type	Description
  first_name string required	string	First name.
  last_name string required	string	Last name.
  email string required	string	Email address.
  phone string	string	Mobile phone number.
  send_welcome_email boolean	boolean	Send the welcome email. Default: the studio's own setting.

  Example input

  {
    "first_name": "first name",
    "last_name": "last name",
    "email": "jane@example.com"
  }

  Example response

  {
    "client_id": "102210",
    "name": "Lena Ortiz",
    "email": "lena@example.com",
    "welcome_email_sent": true
  }

• update_client Change a client's contact details. write

  Edits the fields you pass on the client's Client Info and leaves the rest as it is. It returns the client as saved. It needs the staff permission to edit client info. It reaches no one and is undone with one more call, so it does not wait for your OK.

  MCP callmindbody_write → update_client

  REST endpointPATCH https://cotlet.dev/api/v1/mindbody/clients/{client_id}

  Parameters

  Parameters: update_client

  Name	Type	Description
  client_id string required	string	Client ID from search_clients.
  email string	string	New email address.
  phone string	string	New mobile phone number.

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "100234",
    "name": "Ana Lopez",
    "email": "ana.lopez@example.com",
    "phone": "555 0142",
    "updated": [
      "email",
      "phone"
    ]
  }

ToolWhat it doesAccess

• book_client_into_class Enroll a client in a class. writeasks first

  Adds the client to the class roster, or to the waitlist when the class is full and has a waitlist, and returns the booking and the place. The studio's own rules still apply: a client without a valid pricing option is not booked, and the call returns the reason. The studio's class confirmation email goes to the client if that notification is on. By default you confirm each call; you can switch that off for this tool.

  MCP callmindbody_write → book_client_into_class

  REST endpointPOST https://cotlet.dev/api/v1/mindbody/class/{class_id}/clients/{client_id}/into-class

  Parameters

  Parameters: book_client_into_class

  Name	Type	Description
  client_id string required	string	Client ID from search_clients.
  class_id string required	string	Class ID from list_classes.

  Example input

  {
    "client_id": "100234",
    "class_id": "c_48125"
  }

  Example response

  {
    "booking_id": "b_90420",
    "class_id": "c_48125",
    "client_id": "100234",
    "place": "roster",
    "booked": 15,
    "capacity": 20
  }

• cancel_client_booking Cancel one client's booking in a class. writeasks first

  Cancels one booking from get_class_roster. cancel_type is early or late: Mindbody applies the studio's own policy, so a late cancel can use up a visit or charge a fee. The studio's cancellation email goes to the client if that notification is on. A cancelled booking is put back with book_client_into_class, not with an undo. By default you confirm each call; you can switch that off for this tool.

  MCP callmindbody_write → cancel_client_booking

  REST endpointPOST https://cotlet.dev/api/v1/mindbody/bookings/{booking_id}/client-booking/cancel

  Parameters

  Parameters: cancel_client_booking

  Name	Type	Description
  booking_id string required	string	Booking ID from get_class_roster.
  cancel_type enum required	enum	early or late.

  Example input

  {
    "booking_id": "booking_8c41d2",
    "cancel_type": "early"
  }

  Example response

  {
    "booking_id": "b_90311",
    "client_id": "100234",
    "status": "cancelled",
    "cancel_type": "early"
  }

• terminate_client_contract Terminate a client's contract and stop its autopays. writeasks first

  Terminates the contract from list_client_contracts, which ends its remaining autopays. It needs the staff permission to terminate client contracts. A termination can be cancelled while the contract's end date has not passed; after that the contract has to be sold again. By default you confirm each call; you can switch that off for this tool.

  MCP callmindbody_write → terminate_client_contract

  REST endpointPOST https://cotlet.dev/api/v1/mindbody/contracts/{contract_id}/clients/{client_id}/contract/terminate

  Parameters

  Parameters: terminate_client_contract

  Name	Type	Description
  contract_id string required	string	Contract ID from list_client_contracts.
  client_id string required	string	Client ID the contract belongs to.

  Example input

  {
    "contract_id": "contract_8c41d2",
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "contract_id": "ct_5521",
    "client_id": "100234",
    "status": "Terminated",
    "autopays_stopped": true
  }

ToolWhat it doesAccess

• get_attendance_report Attendance with revenue for a date range, per class. read

  Reads the Attendance with Revenue report from Insights > Reports for the dates you give, one row per class with the booked and signed-in counts. It needs the staff permission for that report; without it the call fails with a permission error and the agent says which permission is missing.

  MCP callmindbody_read → get_attendance_report

  REST endpointGET https://cotlet.dev/api/v1/mindbody/attendance-report

  Parameters

  Parameters: get_attendance_report

  Name	Type	Description
  start_date date required	date	First day of the report.
  end_date date required	date	Last day of the report.

  Example input

  {
    "start_date": "2026-10-01",
    "end_date": "2026-10-01"
  }

  Example response

  {
    "rows": [
      {
        "class": "Morning Vinyasa",
        "date": "2026-11-03",
        "booked": 18,
        "signed_in": 16
      },
      {
        "class": "Evening Spin",
        "date": "2026-11-03",
        "booked": 15,
        "signed_in": 13
      }
    ],
    "totals": {
      "booked": 33,
      "signed_in": 29
    }
  }

• list_staff_schedule The classes each teacher is scheduled for. read

  Reads the Staff Schedule report (Insights > Reports > Staff > Administrative): the classes each teacher is scheduled for in the dates you give, grouped by teacher. It needs the staff permission Schedule at a Glance/Attendance (Everyone's Schedule).

  MCP callmindbody_read → list_staff_schedule

  REST endpointGET https://cotlet.dev/api/v1/mindbody/staff-schedules

  Parameters

  Parameters: list_staff_schedule

  Name	Type	Description
  start_date date required	date	First day to list.
  end_date date	date	Last day to list. Default: the same day as start_date.

  Example input

  {
    "start_date": "2026-10-01"
  }

  Example response

  {
    "teachers": [
      {
        "name": "Dana Reyes",
        "classes": [
          {
            "name": "Morning Vinyasa",
            "starts_at": "2026-11-10T07:00:00"
          }
        ]
      },
      {
        "name": "Sam Okafor",
        "classes": [
          {
            "name": "Lunch Pilates",
            "starts_at": "2026-11-10T12:15:00"
          }
        ]
      }
    ]
  }