[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup) # ClassPass API and MCP server: Let your AI agent book your ClassPass classes. > ClassPass has no member API and no MCP server (checked 28 Oct 2026). Its one official API, the Inventory API, is for approved scheduling software that sends a studio's classes to ClassPass. Cotlet runs 9 ClassPass tools hosted, over MCP for agents and REST for scripts, in your own login. Book classes with credits and run your studio roster and reports. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST. [MCP setup](https://cotlet.dev/integrations/classpass-api-mcp-server.md#connect) [REST API guide](https://cotlet.dev/integrations/classpass-api-mcp-server.md#rest-api) - Free 7-day trial, no card - Unofficial, not affiliated with ClassPass - Page: https://cotlet.dev/integrations/classpass-api-mcp-server ## What can you automate in ClassPass? - Find a class within your credits - Book around your calendar - Cancel before the late fee - Read a studio roster - Mark no-shows within 48 h - Report reservations and payouts ## Does ClassPass have an MCP server or an API? - The Inventory API lets ClassPass "obtain a venue's schedules from third parties" and pass back reservations and attendance. The spec sits behind an approved partner login, under API Access Terms dated 6 Jan 2026. - Nothing official searches, books or cancels for a member, and the partner portal's reports and payouts have no API. Zapier and n8n have no ClassPass app (both pages return 404). - One community MCP server for members appeared on GitHub on 21 Oct 2026; it runs on your computer with your ClassPass password. | What you need | Inventory API | GitHub MCP server | Cotlet | |---|---|---|---| | Who can use it | Approved scheduling software | Any member | Members and studios | | Search, book and cancel classes | No | Yes | Yes, after your OK | | Rosters and no-shows | Through your booking software | No | Yes, partner portal | | Reservation and payout reports | No | No | Yes | | Runs with your computer off | Yes | No | Yes, hosted | Checked 28 Oct 2026. Sources: [ClassPass Developers: Inventory API](https://developers.classpass.com/specInfo), [ClassPass Help: ClassPass API Access Terms of Use](https://help.classpass.com/hc/en-us/articles/360061293531-What-is-ClassPass-s-API-Access-Terms-of-Use), [ClassPass Partners: Booking integrations](https://classpass.com/partners/classpass-booking-integrations), [ClassPass Help: How do I cancel a fitness class or wellness reservation?](https://help.classpass.com/hc/en-us/articles/204335739-How-do-I-cancel-a-fitness-class-or-wellness-reservation), [dvcrn/mcp-server-classpass on GitHub](https://github.com/dvcrn/mcp-server-classpass) ## How does Cotlet connect to ClassPass? 1. **Sign in to ClassPass.** Use your own account in its Cotlet Cloud Browser. 2. **Choose MCP or REST.** Connect your agent or create a Cotlet API key. 3. **Run your workflow.** Ask your agent or send an HTTP request. We never keep your ClassPass password, and no booking, cancel or no-show goes through until you approve it. ## Connect ClassPass to your agent or workflow Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide. 1. **Enable ClassPass for agents.** Sign up, log in to ClassPass (member app or partner portal) in its Cloud Browser, then press Enable for agents. 2. **Add the Cotlet address.** Put https://cotlet.dev/mcp/v1 into your agent's MCP server or connector settings. 3. **Approve the connection.** Chat apps open a Cotlet sign-in; editors, n8n and scripts use an API key from the console. One address, `https://cotlet.dev/mcp/v1`, serves ClassPass and every other app you enable. Turned ClassPass on after connecting? Refresh the connector to load its tools. Claude: ``` Settings > Connectors > Add custom connector URL: https://cotlet.dev/mcp/v1/connect Claude Code: claude mcp add --transport http cotlet-classpass \ https://cotlet.dev/mcp/v1 \ --header "Authorization: Bearer $COTLET_API_KEY" ``` ChatGPT: ``` Settings > Apps & Connectors > Create MCP server URL: https://cotlet.dev/mcp/v1/connect Authentication: OAuth ``` Cursor: ``` // ~/.cursor/mcp.json { "mcpServers": { "cotlet-classpass": { "url": "https://cotlet.dev/mcp/v1", "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" } } } } ``` Codex: ``` # ~/.codex/config.toml [mcp_servers.cotlet-classpass] url = "https://cotlet.dev/mcp/v1" bearer_token_env_var = "COTLET_API_KEY" ``` n8n: ``` MCP Client Tool (inside an AI Agent) Transport: HTTP Streamable URL: https://cotlet.dev/mcp/v1 Auth: Bearer, Tool: classpass_read ``` Make, Zapier: ``` Make: MCP Client > Call a tool Zapier: MCP Client by Zapier > Run Tool Server URL: https://cotlet.dev/mcp/v1 Token: Tool: classpass_write ``` ## How to use the ClassPass REST API ### Create your Cotlet API key Create a Cotlet API key with access to ClassPass and its read operations. Store it as `COTLET_API_KEY` in your environment or automation platform's credential store. Connect ClassPass in Cotlet and enable it for agents. Account access: Your own ClassPass member account, or your studio login for partners.classpass.com. ### Make your first ClassPass API request REST: ``` curl https://cotlet.dev/api/v1/classpass/reservations \ -H "Authorization: Bearer $COTLET_API_KEY" ``` ### Read my reservations and apply the operation limits A successful REST call puts the tool output in `result`. This illustrative response excerpt omits call IDs, messages and credit details. Illustrative response excerpt: ``` { "status": "success", "app": "classpass", "tool": "list_reservations", "result": { "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" } ] } } ``` 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. Member reads and studio reads require their respective account roles; choose the operations that match your login. Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination. ### ClassPass workflows for agents and automations | Tool | Connect through | Example workflow | |---|---|---| | n8n | HTTP Request | Read one class with its cancellation policy and credit cost. Use `get_class` in your configured private activity report. | | Make | HTTP > Make a request | Read the reservation report of your studio for a date range. Use `get_reservation_report` in your configured private activity report. | | Python or Node.js | REST API | Read the payout reports of your studio. Use `get_payout_report` in your configured private activity report. | Send `Authorization: Bearer ` in request headers. You configure the schedule, destination and record comparisons. Cotlet reads ClassPass; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template. Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports. The [API and MCP reference](https://cotlet.dev/integrations/classpass-api-mcp-server.md#tools) lists operations and inputs. The [REST API guide](https://cotlet.dev/docs/api.md) explains authentication, errors and approvals. ## ClassPass API endpoints and MCP tools ### Member: classes and reservations Results and credit prices follow your account's city and plan. A booking spends credits, so it asks first; read get_class for the late cancel fee before you book. - **Search classes** (`search_classes`, read): Search bookable classes and appointments near a place. - **Get class details** (`get_class`, read): Read one class with its cancellation policy and credit cost. - **List my reservations** (`list_reservations`, read): List the signed-in member's upcoming reservations. - **Book a class** (`book_class`, write, asks first): Book a class with your credits. - **Cancel a reservation** (`cancel_reservation`, write, asks first): Cancel one of your reservations. ### Studio: rosters, reports and payouts Needs a partner portal login. Attendance can change only within 48 hours after a class, and a no-show can cost the member a fee. - **List class roster** (`list_class_roster`, read): List the ClassPassers on a class at your studio. - **Mark attendance** (`mark_attendance`, write, asks first): Mark a ClassPasser as attended or no-show on a roster. - **Get reservation report** (`get_reservation_report`, read): Read the reservation report of your studio for a date range. - **Get payout report** (`get_payout_report`, read): Read the payout reports of your studio. Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/classpass-api-mcp-server#tools ## Who can see my ClassPass session, and how do I revoke it? - **What we store.** Your logged-in ClassPass profile, AES-256-GCM, in Finland. Not the password. - **What your agent gets.** The 9 ClassPass tools. No password, no token. - **What the session sees.** Your credits and bookings, or for a studio its rosters and payouts. - **What no tool touches.** Your plan, payment card, credit top-ups and account settings. - **If ClassPass logs you out.** Your agent gets a link and you log in again yourself. - **How to cut access.** Disable for agents, reset the browser or delete the key. ClassPass Terms 7 (c) ban sharing your password; with Cotlet you type it into ClassPass's own login page and Cotlet does not store it. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)); there is no SOC 2 report or third-party pentest yet. ## Is it against ClassPass's terms? Account safety > Use any robot, spider, scraper, or other automated means to access the Site for any purpose without our express written permission or bypass our robot exclusion headers or other measures we may use to prevent or restrict access to the Site; > > [ClassPass Terms of Use, section 7 (s), last updated 29 Oct 2025](https://classpass.com/terms/usa) Item 7 (m) also bans scripts for "scraping, indexing, surveying, or otherwise data mining", and section 5 lets ClassPass close an account "at any time and without prior notice". An agent in your session could count as automated means, and so could any GitHub server or booking bot. We found no public case of a member or studio account closed for automation (checked 28 Oct 2026), though a Telegram auto-booking bot advertises openly. How we keep your account looking like you: - One account, yours, logged in by you - One Cloud Browser with a steady IP and cookies - Bookings, cancels and no-shows wait for your OK (3 tools) - No sniping a spot the second booking opens, no bulk searches - If ClassPass objects, we pause the ClassPass tools for everyone within 24 h > Ask for a few classes at a time. A search that sweeps a whole city every hour is what 7 (m) calls data mining. ## What happens when ClassPass changes? - **12 h** between tests of the ClassPass reads - **24 h** between tests of bookings and roster changes - **$0** for a call to a ClassPass tool paused for repair ClassPass now belongs to Playlist with Mindbody and Booker (June 2025), so its app and partner portal keep moving. When a screen or a field changes, we fix the tool and your agent calls it the same way. [status.cotlet.dev](https://status.cotlet.dev) checks the site, console and API every 3 minutes. ## Approvals, undo and mistakes 1. **Searches near you.** Classes with a free spot, under your credit limit. 2. **Reads the policy.** Credit cost and late cancel fee of that one booking. 3. **Waits for your OK.** The booking sits in your Cotlet console until you approve. 4. **Reports back.** Reservation, credits spent and the free-cancel deadline. | Action | Undo | |---|---| | Book a class | Cancel it; before the free-cancel deadline the credits come back | | Cancel a reservation | Book again if a spot is still free | | Cancel inside the late window | No, the fee in the Cancellation Policy may apply | | Mark a no-show | Set it back to attended, within 48 hours of the class | 3 of 9 tools ask first: every write, because each one moves credits or fees. Turn the wait off per tool if you trust a weekly booking run. > A full class or too few credits makes book_class fail and nothing is booked. A failed call costs nothing. MCP call: ``` { "name": "book_class", "arguments": { "class_id": "cls_90417", "confirm": true } } ``` REST: ``` curl -X POST https://cotlet.dev/api/v1/classpass/class/cls_90417 \ -H "Authorization: Bearer $COTLET_API_KEY" \ -H "Content-Type: application/json" \ -d '{"confirm":true}' ``` Response: ``` { "reservation_id": "rsv_48299", "class_id": "cls_90417", "status": "booked", "credits_spent": 6, "free_cancel_until": "2026-10-29T06:30:00-04:00" } ``` Scripts and cron jobs reach the same tools over REST at `/api/v1/classpass`, with the same key and the same price per call. The REST path of each tool is in the tools table above. ## How much does the ClassPass MCP server cost? **About $10 a month** for one member's bookings on a 33-credit plan, 1,760 credits. Your ClassPass plan is billed by ClassPass as before. | Job | Calls | Credits | |---|---|---| | Find and book a class that fits the calendar | 3 × 6 | 180 | | Look at the week ahead, weekly | 1 × 4 | 40 | | Cancel before the late window | 2 × 2 | 40 | | Cloud Browser, 30 days | | 1,500 | | Total | | 1,760 | - Free 7-day trial, no card - 10 credits per successful call, MCP or REST - 50 credits a day for the Cloud Browser - One-time packs, valid 12 months, no subscription The month assumes the US plan of 33 credits for $69 and classes at 5 to 7 credits: about 6 bookings. A studio with a daily roster and no-show pass, a weekly report and one payout read comes to 2,150 credits, about $12. Dollars at the $29 pack rate. ## ClassPass MCP server on GitHub, a booking bot or hosted: which to use | Option | What it does | Where it stops | |---|---|---| | [dvcrn/mcp-server-classpass](https://github.com/dvcrn/mcp-server-classpass) | Member MCP server in Go: search, venues, slots, book, cancel, bookmarks. 0 stars, first release 21 Oct 2026, AGPL-3.0. | Runs on your computer with your password or an app token you read with a proxy; no studio tools. | | [Telegram @classpass_reservations_bot](https://toptelegrambots.com/list/classpass_reservations_bot) | Books a class the moment booking opens, 1 free booking a month. | Takes your ClassPass token; one job only, and exactly what section 7 (s) names. | | [Apify ClassPass scraper](https://apify.com/scrapersdelight/classpass-studios-scraper/api/mcp) | Studio lead lists by city, from $0.45 per 1,000 venues, also as MCP. | Public listings only, nothing in your account. | | Your booking software | Mindbody, Zen Planner, Vagaro and 100+ others send your schedule to ClassPass. | Syncs classes and spots; no partner portal reports or payouts for an agent. | If you are a member who runs your own tools, the GitHub server does the booking side for free. Studios have no other agent route to the partner portal. Cotlet suits both when the agent should run without your computer and ask before it spends credits. ## Who runs Cotlet Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev about the ClassPass tools. ## ClassPass API and MCP: questions ### How do I get access? Open a free account at https://cotlet.dev, find ClassPass under Integrations in the console and log in to ClassPass in its Cloud Browser. The trial starts with your first app and asks for no card. ### How do I connect ClassPass to ChatGPT or Claude? Sign up at cotlet.dev, log in to ClassPass once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your ClassPass account through Cotlet, in their phone apps too. ### What can ChatGPT do in ClassPass? With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in ClassPass: find and book a class that fits my calendar; check upcoming reservations and cancel in time; mark attendance after class. You ask in plain words, and anything that reaches other people waits for your OK first. ### Do I need a member or a studio account? It depends on the tool. search_classes, get_class, list_reservations, book_class and cancel_reservation work in a member account. list_class_roster, mark_attendance, get_reservation_report and get_payout_report need a studio login to partners.classpass.com. ClassPass describes both sides in its help center and partner pages. ### What does a late cancel cost? ClassPass lets you cancel up to 12 hours before the start with no charge, unless the booking shows an earlier deadline. Inside that window it returns the credits and may charge a late cancellation fee, shown in the Cancellation Policy of each reservation. Read get_class before booking. ### Can the agent grab a spot the second it opens? No. Cotlet books when you ask, after your OK, and does not poll for openings. Sniping a spot is the kind of automated access ClassPass Terms 7 (s) name. ### Does it buy credits or change my plan? No. No tool tops up credits, changes your plan or touches your card. book_class spends credits you already have. ### Does ClassPass have webhooks? Only for approved partner software inside the Inventory API. To act on new bookings or rosters, run your agent on a schedule, for example a list_class_roster pass each evening. ### Is the MCP server different from the REST API? Only in how you call it. Both carry the same 9 tools, inputs, answers, key and price. Agents use MCP; scripts and HTTP steps use REST. ### Is Cotlet affiliated with ClassPass? No. Cotlet is independent and not affiliated with ClassPass or Playlist. ### Can I use the ClassPass API without an AI agent? Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST. --- Give your AI agents your signed-in browser. **Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md) **Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet) **Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) **Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md) **Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors) **Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet) Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md) Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.