ClassPass API and MCP server Let your AI agent book your ClassPass classes.

ToolWhat it doesAccess

• search_classes Search bookable classes and appointments near a place. read

  Returns classes with a bookable spot, earliest first, with venue, start time, credit cost and a class_id. The results are the ones the ClassPass app shows for your account and plan. Studios and prices differ by city.

  MCP callclasspass_read → search_classes

  REST endpointGET https://cotlet.dev/api/v1/classpass/classes/search

  Parameters

  Parameters: search_classes

  Name	Type	Description
  location string required	string	City, neighborhood or address.
  query string	string	Activity or studio name, for example pilates.
  date string	string	Date as YYYY-MM-DD. Defaults to today.
  max_credits integer	integer	Only classes that cost this many credits or fewer.

  Example input

  {
    "location": "location"
  }

  Example response

  {
    "classes": [
      {
        "class_id": "cls_90417",
        "venue": "Harbor Pilates",
        "name": "Reformer Basics",
        "starts_at": "2026-10-29T18:30:00-04:00",
        "credits": 6,
        "spots_left": 3
      },
      {
        "class_id": "cls_90433",
        "venue": "Studio Rise",
        "name": "Mat Pilates",
        "starts_at": "2026-10-29T19:00:00-04:00",
        "credits": 5,
        "spots_left": 1
      }
    ]
  }

• get_class Read one class with its cancellation policy and credit cost. read

  Returns the class, venue, start time, credits and the Cancellation Policy ClassPass shows for that booking, including the late cancel fee. Read it before book_class, because the fee differs by booking.

  MCP callclasspass_read → get_class

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

  Parameters

  Parameters: get_class

  Name	Type	Description
  class_id string required	string	Class id from search_classes.

  Example input

  {
    "class_id": "class_8c41d2"
  }

  Example response

  {
    "class_id": "cls_90417",
    "venue": "Harbor Pilates",
    "name": "Reformer Basics",
    "starts_at": "2026-10-29T18:30:00-04:00",
    "credits": 6,
    "late_cancel_hours": 12,
    "late_cancel_fee": "$15.00"
  }

• list_reservations List the signed-in member's upcoming reservations. read

  Returns upcoming reservations in start order with venue, start time, credits used and the cancellation deadline shown for each booking. It reads the Upcoming list of the member account. A studio login has no member reservations and gets an empty list.

  MCP callclasspass_read → list_reservations

  REST endpointGET https://cotlet.dev/api/v1/classpass/reservations

  Parameters

  No parameters.

  Example response

  {
    "reservations": [
      {
        "reservation_id": "rsv_48213",
        "venue": "Harbor Pilates",
        "class": "Reformer Basics",
        "starts_at": "2026-10-30T18:30:00-04:00",
        "credits": 6,
        "free_cancel_until": "2026-10-30T06:30:00-04:00"
      }
    ]
  }

• book_class Book a class with your credits. writeasks first

  Reserves one spot and spends the credits shown on the class. Returns the reservation and its free-cancel deadline. A full class or too few credits returns an error and books nothing. By default you confirm each call; you can switch that off for this tool.

  MCP callclasspass_write → book_class

  REST endpointPOST https://cotlet.dev/api/v1/classpass/class/{class_id}

  Parameters

  Parameters: book_class

  Name	Type	Description
  class_id string required	string	Class id from search_classes.
  confirm boolean	boolean	Must be true. Booking spends credits.

  Example input

  {
    "class_id": "cls_90417",
    "confirm": true
  }

  Example response

  {
    "reservation_id": "rsv_48299",
    "class_id": "cls_90417",
    "status": "booked",
    "credits_spent": 6,
    "free_cancel_until": "2026-10-29T06:30:00-04:00"
  }

• cancel_reservation Cancel one of your reservations. writeasks first

  Cancels through ClassPass, as the app does. Before the free-cancel deadline the credits return at once. Inside the late window ClassPass returns the credits and may charge a late cancellation fee, which the call shows before it acts. By default you confirm each call; you can switch that off for this tool.

  MCP callclasspass_write → cancel_reservation

  REST endpointPOST https://cotlet.dev/api/v1/classpass/reservations/{reservation_id}/cancel

  Parameters

  Parameters: cancel_reservation

  Name	Type	Description
  reservation_id string required	string	Reservation id from list_reservations.
  confirm boolean	boolean	Must be true. A late cancel can charge a fee.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "rsv_48299",
    "status": "cancelled",
    "credits_returned": 6,
    "late_cancel_fee": null
  }

ToolWhat it doesAccess

• list_class_roster List the ClassPassers on a class at your studio. read

  Returns each class of the day with its roster: name, status and whether the client is new or repeat. ClassPass marks everyone Attended by default and gives you 48 hours after the class to change a status. Needs a studio login to the partner portal.

  MCP callclasspass_read → list_class_roster

  REST endpointGET https://cotlet.dev/api/v1/classpass/class-rosters

  Parameters

  Parameters: list_class_roster

  Name	Type	Description
  date string required	string	Date as YYYY-MM-DD.
  class_name string	string	Only classes whose name contains this text.

  Example input

  {
    "date": "date"
  }

  Example response

  {
    "classes": [
      {
        "class_id": "cls_90100",
        "name": "Evening Flow",
        "starts_at": "2026-10-27T18:30:00-04:00",
        "roster": [
          {
            "name": "Dana K.",
            "status": "attended",
            "visit": "repeat"
          },
          {
            "name": "Lee M.",
            "status": "attended",
            "visit": "new"
          }
        ]
      }
    ]
  }

• mark_attendance Mark a ClassPasser as attended or no-show on a roster. writeasks first

  Sets the roster status you would set with the check or X icon. It must happen within 48 hours after the class. A no-show can lead to a missed reservation fee for the member, so it reaches money and waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callclasspass_write → mark_attendance

  REST endpointPOST https://cotlet.dev/api/v1/classpass/class/{class_id}/attendance/mark

  Parameters

  Parameters: mark_attendance

  Name	Type	Description
  class_id string required	string	Class id from list_class_roster.
  client_name string required	string	Name as shown on the roster.
  status string required	string	attended or no_show.

  Example input

  {
    "class_id": "class_8c41d2",
    "client_name": "client name",
    "status": "status"
  }

  Example response

  {
    "class_id": "cls_90100",
    "client_name": "Lee M.",
    "status": "no_show"
  }

• get_reservation_report Read the reservation report of your studio for a date range. read

  Returns the totals and the rows of Reports > Reservations: reserved, attended, late-canceled and no-show. Same data as the CSV download in the partner portal. Needs a studio login.

  MCP callclasspass_read → get_reservation_report

  REST endpointGET https://cotlet.dev/api/v1/classpass/reservation-report

  Parameters

  Parameters: get_reservation_report

  Name	Type	Description
  start_date string required	string	First day as YYYY-MM-DD.
  end_date string required	string	Last day as YYYY-MM-DD.
  location string	string	Location name when the studio has several.

  Example input

  {
    "start_date": "start date",
    "end_date": "end date"
  }

  Example response

  {
    "range": {
      "start": "2026-10-19",
      "end": "2026-10-25"
    },
    "totals": {
      "reserved": 118,
      "attended": 96,
      "late_canceled": 14,
      "no_show": 8
    },
    "rows": [
      {
        "class": "Evening Flow",
        "date": "2026-10-21",
        "reserved": 12,
        "attended": 10,
        "late_canceled": 1,
        "no_show": 1
      }
    ]
  }

• get_payout_report Read the payout reports of your studio. read

  Returns the payout summary and the earnings by reservation that the partner portal shows for the month. ClassPass calculates the balance after month end and pays it out in the first week of the next month. Needs a studio login.

  MCP callclasspass_read → get_payout_report

  REST endpointGET https://cotlet.dev/api/v1/classpass/payout-report

  Parameters

  Parameters: get_payout_report

  Name	Type	Description
  month string	string	Month as YYYY-MM. Defaults to the latest payout.

  Example response

  {
    "month": "2026-09",
    "payout_total": 4180.5,
    "currency": "USD",
    "reservations": 312,
    "paid_on": "2026-10-06"
  }