[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)

# Hapana API and MCP server: Let your AI agent run the front desk paperwork.

> Hapana has an API, tied to its plans. Premium includes read-only API access with self-service keys and read webhooks. Pro includes full read and write APIs with self-service keys, all webhooks and metered premium actions. No Hapana MCP server and no official ChatGPT or Claude connector was found.

Hapana sells a read-only API on Premium and a read and write API on Pro, and no MCP server (checked 15 Nov 2026). Cotlet runs a hosted Hapana MCP server with 31 tools that ChatGPT and Claude use in your own CORE login. Charges, membership changes and member messages wait for your OK.

- Free 7-day trial, no card
- Unofficial, not affiliated with Hapana
- Page: https://cotlet.dev/integrations/hapana-api-mcp-server

## What can your AI agent do in Hapana?

- Charge no-show fees after class
- Pause, cancel or reactivate a membership
- Book a member or a group into a class
- Put a substitute on a class
- Chase delinquent members
- Fix the time clock and run payroll

## Does Hapana have an MCP server or an API?

- Hapana lists Zapier and Middle as API connectors, and CORE sets up Zapier webhooks under Account Settings, Integrations.
- Hapana Assistant, on Pro, queries the audit log inside Hapana; it is not a connector for outside AI agents.
- Hapana Login was previously OneFitStop; CORE runs at core.hapana.com.

| What you need | Hapana API | By hand | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | No MCP server | Copy and paste | Hosted MCP server |
| Change memberships, bookings and charges | Pro plan, your own code | One screen at a time | 31 tools, writes after your OK |
| Read clients, schedule and reports | Premium or Pro | One screen at a time | Any plan, your login |
| Run from n8n or a script | With your own client | Manual only | REST, same key |

Checked 15 Nov 2026. Sources: [Hapana pricing](https://www.hapana.com/pricing), [Hapana API connectors](https://www.hapana.com/integrations/api-connectors), [KB: Set Up and Manage Your Integrations](https://support.hapana.com/kb/article/721), [KB: Create Memberships and Packages](https://support.hapana.com/kb/article/753), [KB: Schedule templates](https://support.hapana.com/kb/article/761), [KB: Add a New Session](https://support.hapana.com/kb/article/758), [KB: Session Types](https://support.hapana.com/kb/article/751), [KB: Add a New Client](https://support.hapana.com/kb/article/728), [KB: Process a New Sale](https://support.hapana.com/kb/article/764), [KB: Process a Refund](https://support.hapana.com/kb/article/663), [KB: Suspend a Membership](https://support.hapana.com/kb/article/661), [KB: Cancel a Membership](https://support.hapana.com/kb/article/755), [KB: Reactivate a Membership](https://support.hapana.com/kb/article/41), [KB: Bulk messages](https://support.hapana.com/kb/article/719), [KB: Email campaign in GROW](https://support.hapana.com/kb/article/637), [KB: Bulk SMS in GROW](https://support.hapana.com/kb/article/648), [KB: No Show Fee](https://support.hapana.com/kb/article/690), [KB: Check In a Client](https://support.hapana.com/kb/article/623), [KB: Book a Group Exercise Class](https://support.hapana.com/kb/article/775), [KB: Promo Codes](https://support.hapana.com/kb/article/760), [KB: POS Products](https://support.hapana.com/kb/article/759), [KB: Retail and Gift Card Sales](https://support.hapana.com/kb/article/765), [KB: Merge Duplicate Clients](https://support.hapana.com/kb/article/676), [KB: Client Groups](https://support.hapana.com/kb/article/679), [KB: Leads](https://support.hapana.com/kb/article/680), [KB: Workout Programs](https://support.hapana.com/kb/article/681), [KB: Substitute an Instructor](https://support.hapana.com/kb/article/684), [KB: Bulk Cancel Sessions](https://support.hapana.com/kb/article/799), [KB: Pending Payment](https://support.hapana.com/kb/article/176), [KB: Add Credits to a Package](https://support.hapana.com/kb/article/664), [KB: Extend Package Credit Validity](https://support.hapana.com/kb/article/810), [KB: Package Agreement Signature](https://support.hapana.com/kb/article/31), [KB: Manual Time Clock Entry](https://support.hapana.com/kb/article/365), [KB: Create a Free Class](https://support.hapana.com/kb/article/153), [KB: Rooms as Bookable Resources](https://support.hapana.com/kb/article/152), [KB: Re-send an Invoice](https://support.hapana.com/kb/article/709), [KB: Waitlist](https://support.hapana.com/kb/article/672), [KB: Payroll Report](https://support.hapana.com/kb/article/883), [KB: Delinquency Report](https://support.hapana.com/kb/article/823), [KB: Export Contacts](https://support.hapana.com/kb/article/653), [KB: Import Contacts](https://support.hapana.com/kb/article/693), [KB: Bulk Edits to Memberships](https://support.hapana.com/kb/article/660)

## How does the Hapana MCP server work?

1. **Sign in to Hapana.** Once, in a browser we host for you.
2. **Connect your AI agent.** One address in its settings.
3. **Hand it the desk work.** It lists the change, you approve it.

Your agent works in your own signed-in Cloud Browser. Charges, refunds, membership changes and member messages wait for your OK.

## How to connect Hapana to your AI agent

1. **Sign in to Hapana in a Cloud Browser.** Open core.hapana.com/login in your Cotlet Cloud Browser and sign in with your own CORE login. Add GROW in the same browser if you use it.
2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. **Let the agent in.** Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Hapana sits on the shared address `https://cotlet.dev/mcp/v1` with every other app you enable, so one connector covers them all. Turned Hapana on after connecting? Refresh the connector and the 31 Hapana tools appear.

ChatGPT:

```
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
```

Claude:

```
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

Cursor:

```
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
```

Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet]
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, <your key>
Tool: hapana_read
```

## All 31 Hapana MCP tools

One tool per workflow in the Hapana Knowledge Base, across CORE and GROW. The three read tools run at once; every write asks first.

### Clients, leads and programs

Start with find_client: most tools take the client it returns. Groups are reused for messages and class bookings.

- **Find a client** (`find_client`, read): Search clients by name, email or phone and read their memberships, packages and payments.
- **Add a new client** (`add_client`, write, asks first): Add a client to CORE, with or without a welcome email.
- **Merge duplicate client records** (`merge_clients`, write, asks first): Merge a duplicate client profile into the one you keep.
- **Create client groups** (`manage_client_groups`, write, asks first): List client groups, create one or add clients to it.
- **Add leads** (`manage_leads`, write, asks first): List leads, add one, assign it to a team member or update it.
- **Send workout programs** (`send_workout_program`, write, asks first): Create a workout program and send it to a client or a group.

### Memberships and packages

Suspend, cancel or bring back a membership, top up or extend a pack, change future rates and send agreements to sign.

- **Suspend, cancel or reactivate a membership** (`update_membership_status`, write, asks first): Suspend, cancel, or reactivate a client's membership.
- **Add credits or extend package expiry** (`update_package_credits`, write, asks first): Add or deduct credits on a client's package, or move its credit expiry date.
- **Edit memberships and packages in bulk** (`edit_future_payments`, write, asks first): Change the rate of future membership payments for one client or many.
- **Send a package agreement for signature** (`send_package_agreement`, write, asks first): Send a client the agreement of a package or membership to sign on their own device.

### Sales and payments

Every tool here moves money. Refunds go back to the original payment method.

- **Record a new sale** (`process_sale`, write, asks first): Sell a membership, package, product, gift card or custom charge to a client.
- **Refund or collect a membership payment** (`membership_payment`, write, asks first): Refund a payment from a membership's history, or collect a pending one.
- **Charge a no-show fee** (`charge_no_show_fee`, write, asks first): Charge the no-show fee to clients who missed a finished class.
- **Send an invoice copy** (`send_invoice_email`, write, asks first): Find a client's invoice and email a copy.

### Schedule and bookings

Read the day, add classes, book members or a whole group, check people in, cover instructors and cancel in bulk.

- **List sessions on the schedule** (`list_sessions`, read): Read classes for a date range with instructor, capacity, bookings and waitlist.
- **Add a session to the schedule** (`add_session`, write, asks first): Add a class to the schedule, once or recurring, paid or free.
- **Book a client into a class** (`book_client`, write, asks first): Book a member or a client group into a class, or onto its waitlist when full.
- **Check a client in to a session** (`check_in_client`, write, asks first): Mark a booked client as attended, today or for a past session.
- **Assign a replacement class instructor** (`change_instructor`, write, asks first): Put a substitute on a class, or change its primary instructor.
- **Cancel scheduled sessions in bulk** (`bulk_cancel_sessions`, write, asks first): Cancel every session in a date range except the ones you keep.

### Studio setup and retail

Templates and session types, rooms, the memberships and packs you sell, promo codes and POS products.

- **Create schedule templates and session types** (`manage_schedule_templates`, write, asks first): List, create, edit or delete schedule templates and their session types.
- **Configure rooms as bookable resources** (`configure_room`, write, asks first): Add a room to a location and set when it can be booked.
- **Create memberships and packages** (`manage_memberships_packages`, write, asks first): List or create a membership (recurring) or a package (one-time) for sale.
- **Create promo codes** (`manage_promo_codes`, write, asks first): List or create a percentage or dollar promo code.
- **Update POS products** (`manage_pos_products`, write, asks first): Add, edit or remove a product in POS Inventory.

### Messages and marketing

Bulk email, SMS and push from CORE; campaigns, SMS and contact files in GROW.

- **Send bulk messages to client groups** (`send_bulk_message`, write, asks first): Send an email, SMS or push notification to clients or a group in CORE.
- **Send an email campaign** (`send_email_campaign`, write, asks first): Send or schedule a GROW email campaign from a template.
- **Send bulk SMS to contacts** (`send_bulk_sms`, write, asks first): Text a filtered list of GROW contacts, personalised with custom values.
- **Import or export GROW contacts** (`import_export_contacts`, write, asks first): Export filtered contacts to CSV, or import a CSV of contacts.

### Staff time and reports

Missed shifts on the time clock, then the payroll and member delinquency reports.

- **Add a manual time clock entry** (`add_time_clock_entry`, write, asks first): Record a shift a team member forgot to clock.
- **View payroll and delinquency reports** (`get_report`, read): Run the payroll report or the member delinquency report.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/hapana-api-mcp-server#tools

## Who can see my Hapana session, and how do I revoke it?

- **What we store.** Your signed-in Hapana browser profile, AES-256-GCM encrypted, in Finland. Never your password.
- **What your agent gets.** The 31 Hapana tools. The session cookie stays in the Cloud Browser.
- **What the session sees.** The clients, schedule and payments your CORE role can open, and nothing more.
- **What no tool touches.** Team members and roles, payment gateway and payout settings, API keys, integrations and the kiosk.
- **If Hapana signs you out.** You sign in again yourself, in the same Cloud Browser.
- **How to cut access.** Disable Hapana for agents, reset the browser, or log out from all devices in Hapana.

Cotlet never sees or stores your password: you type it into Hapana yourself, and the agent only uses the session that login leaves behind. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)).

## What happens when Hapana changes?

Cotlet watches the apps it serves and updates the Hapana server when CORE or GROW changes a screen, so your agent keeps working without a change on your side.

Some tools depend on what your account has switched on: a waitlist limit in the template, a no-show fee in Retail Settings, package agreements, an SMS number and credits in GROW. The agent works with your setup as it is.

If Hapana signs you out, one click in the Cotlet console reopens the Cloud Browser so you can sign in again.

## Approvals, undo and mistakes

1. **Read the class.** list_sessions after it ends.
2. **Find the no-shows.** Booked, not marked attending.
3. **Show you names and fee.** Nothing is charged yet.
4. **Charge after your OK.** charge_no_show_fee runs.

| Action | How to put it right |
|---|---|
| Suspension or scheduled cancellation | update_membership_status with `active` or `remove_cancellation` |
| Package credits or expiry | Call update_package_credits again with the earlier numbers |
| Fee or sale charged | Refund it with membership_payment to the original method |
| Bulk cancelled sessions | No undo in Hapana: add them back with add_session |
| Message or campaign sent | Already with members: send a correction |

All 28 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 3 read tools, clients, the schedule and reports, run at once.

MCP call:

```
{
  "name": "update_membership_status",
  "arguments": {
    "client": "Example Member",
    "membership": "Unlimited Monthly",
    "status": "suspended",
    "start_date": "2026-11-20",
    "end_date": "2026-12-20"
  }
}
```

REST:

```
curl -X PATCH https://cotlet.dev/api/v1/hapana/membership-status \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client":"Example Member","membership":"Unlimited Monthly","status":"suspended","start_date":"2026-11-20","end_date":"2026-12-20"}'
```

Response:

```
{
  "client": "Example Member",
  "membership": "Unlimited Monthly",
  "status": "suspended",
  "start_date": "2026-11-20",
  "end_date": "2026-12-20"
}
```

The example pauses a membership for a month instead of cancelling it, so the member comes back without buying a new one. A cron job or n8n flow can make the same call over REST at `/api/v1/hapana` with the same key and price, in JSON. Failed calls are free.

## How much does the Hapana MCP server cost?

**About $21 a month** for a single-location boutique studio, 3,630 credits. Your Hapana plan stays as it is.

| Job | Calls | Credits |
|---|---|---|
| Morning schedule read | 1 × 30 | 300 |
| Bookings and waitlist adds for callers | 1 × 60 | 600 |
| No-show fees after classes | 1 × 40 | 400 |
| Pending payments collected | 1 × 20 | 200 |
| Suspensions, cancellations, reactivations | 1 × 20 | 200 |
| Package credit top-ups and extensions | 1 × 15 | 150 |
| Instructor substitutions | 1 × 12 | 120 |
| Weekly member message | 2 × 4 | 80 |
| Payroll and delinquency reports | 2 × 4 | 80 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 213 calls | 3,630 |

The smallest pack, 5,000 credits for $29, covers this month. More locations and classes use more calls.

- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Works on any Hapana plan your login has

Credit packs are one-time purchases, not a subscription. The month above is an example built from our own assumptions, not measured customer usage.

## Hapana MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| Hapana API on Pro | Full read and write, all webhooks, metered premium actions. | Pro plan; you write, host and fix the client. |
| Hapana API on Premium | Read-only access and read webhooks. | No writes: no bookings, charges or membership changes. |
| Zapier and Middle | Hapana's listed connectors for workflow automation. | Triggers and steps you build; not an agent working in CORE. |
| Hapana Assistant | Queries the audit log, on Pro. | Inside Hapana only, not for ChatGPT or Claude. |
| By hand | Every screen in CORE and GROW. | One member at a time, at the desk. |

If you are on Pro and the Hapana API covers your job, use it: it is the vendor's own route. Cotlet fits when you want ChatGPT, Claude or a script working in CORE today, on any plan, from your own login, with nothing to host.

## Who runs Cotlet

Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and 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 with questions about the Hapana tools.

## Hapana MCP server: questions

### How do I get access?

Sign up free at https://cotlet.dev/signup?app=hapana, turn on Hapana under Integrations in the console and sign in at https://core.hapana.com/login in your Cloud Browser. Then connect your AI agent and ask it for today's schedule. The trial needs no card.

### Does Hapana have an API?

Hapana sells API access with its higher plans: Premium includes read-only API access with self-service keys and read webhooks, and Pro adds full read and write APIs, all webhooks and metered premium actions (pricing page, checked 15 Nov 2026). There is no Hapana MCP server and no official ChatGPT or Claude connector. Hapana also lists Zapier and Middle connectors. Cotlet does not use the API: it works in your own signed-in CORE account.

### Does it work with GROW as well as CORE?

Yes, for what the tools cover: email campaigns, bulk SMS and contact import and export run in GROW, the rest in CORE. Sign in to both in the same Cloud Browser if your account uses both.

### Is this the same as Hapana Assistant?

No. Hapana lists Hapana Assistant on its Pro plan for querying the audit log. Cotlet is separate: it lets ChatGPT, Claude or a script do studio work in your account over MCP or REST.

### Which Hapana login should I use?

One with the role for the work: billing access for refunds and membership changes, schedule access for classes, Admin or Manager for the time clock. The agent can do only what that login can do.

### Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 31 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

### Is Cotlet affiliated with Hapana?

No. Cotlet is independent and not affiliated with Hapana.

---

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.
