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

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
Hapana logo Hapana Cloud Browser

31 tools Read and write

Studio admin

What can your AI agent do in Hapana? The daily admin of a gym or studio.

  • 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

API on higher plans, no MCP

Does Hapana have an MCP server or an API? The official Hapana routes, checked 15 November 2026.

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 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.
The Hapana API, working by hand and Cotlet compared
What you need Hapana APIBy handCotlet
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 · Hapana API connectors · KB: Set Up and Manage Your Integrations · KB: Create Memberships and Packages · KB: Schedule templates · KB: Add a New Session · KB: Session Types · KB: Add a New Client · KB: Process a New Sale · KB: Process a Refund · KB: Suspend a Membership · KB: Cancel a Membership · KB: Reactivate a Membership · KB: Bulk messages · KB: Email campaign in GROW · KB: Bulk SMS in GROW · KB: No Show Fee · KB: Check In a Client · KB: Book a Group Exercise Class · KB: Promo Codes · KB: POS Products · KB: Retail and Gift Card Sales · KB: Merge Duplicate Clients · KB: Client Groups · KB: Leads · KB: Workout Programs · KB: Substitute an Instructor · KB: Bulk Cancel Sessions · KB: Pending Payment · KB: Add Credits to a Package · KB: Extend Package Credit Validity · KB: Package Agreement Signature · KB: Manual Time Clock Entry · KB: Create a Free Class · KB: Rooms as Bookable Resources · KB: Re-send an Invoice · KB: Waitlist · KB: Payroll Report · KB: Delinquency Report · KB: Export Contacts · KB: Import Contacts · KB: Bulk Edits to Memberships

Set up once

How does the Hapana MCP server work? The Hapana MCP server by Cotlet: your agent works in your own CORE login.

  1. 1Sign in to Hapana

    Once, in a browser we host for you.

  2. 2Connect your AI agent

    One address in its settings.

  3. 3Hand 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. Who can see your session

Any MCP client

How to connect Hapana to your AI agent

  1. 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. 2

    Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.

  3. 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
3 read, 28 write

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 programs6

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

  • find_client Search clients by name, email or phone and read their memberships, packages and payments. read

    The same search the Clients tab offers. Returns the profile with its memberships and packages, their status and the payment schedule. Most other tools take the client it returns. It changes nothing.

    MCP callhapana_read → find_client

    REST endpointGET https://cotlet.dev/api/v1/hapana/clients/find

    Parameters

    Parameters: find_client
    NameTypeDescription
    query string required string Name, email address or phone number.

    Example input

    {
      "query": "query"
    }

    Example response

    {
      "client": "Example Member",
      "email": "member@example.com",
      "memberships": [
        {
          "name": "Unlimited Monthly",
          "status": "Active",
          "next_payment": "2026-11-20"
        }
      ],
      "packages": [
        {
          "name": "10 Class Pack",
          "credits": 3,
          "expires": "2026-12-01"
        }
      ]
    }
  • add_client Add a client to CORE, with or without a welcome email. writeAsks first

    The client can then buy a membership and book. A welcome email reaches the client, so the agent shows you the details first. Search with find_client before adding, so nobody is added twice. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → add_client

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

    Parameters

    Parameters: add_client
    NameTypeDescription
    fields object required object The sign-up fields your account requires (Account Settings, Configuration): name, email, phone and the rest.
    send_welcome_email boolean boolean Send the client a login link. Default false.

    Example input

    {
      "fields": "fields"
    }

    Example response

    {
      "client": "New Member",
      "email": "new.member@example.com",
      "welcome_email": true,
      "saved": true
    }
  • merge_clients Merge a duplicate client profile into the one you keep. writeAsks first

    Contact details, visit history and remaining credits move into the kept profile. Hapana requires active memberships and packs on the duplicate to be cancelled first; the agent checks and stops if they are not. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → merge_clients

    REST endpointPOST https://cotlet.dev/api/v1/hapana/clients/merge

    Parameters

    Parameters: merge_clients
    NameTypeDescription
    from_client string required string The duplicate to merge from.
    into_client string required string The profile to keep.

    Example input

    {
      "from_client": "from client",
      "into_client": "into client"
    }

    Example response

    {
      "from_client": "Example Member (duplicate)",
      "into_client": "Example Member",
      "merged": true
    }
  • manage_client_groups List client groups, create one or add clients to it. writeAsks first

    Groups are reusable for messages (send_bulk_message) and for booking a whole group into a class (book_client). The list shows each group's member count. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → manage_client_groups

    REST endpointPOST https://cotlet.dev/api/v1/hapana/client-groups/manage

    Parameters

    Parameters: manage_client_groups
    NameTypeDescription
    action string required string One of `list`, `create`, `add_clients`. `list` only reads.
    group string string Group name, for example 6 Week Challenge.
    clients array array Clients to add, by name, email or phone.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "group": "6 Week Challenge",
      "members": 18,
      "saved": true
    }
  • manage_leads List leads, add one, assign it to a team member or update it. writeAsks first

    Works in the Leads tab of Clients in CORE. Assigning gives each team member a clear list of who to follow up. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → manage_leads

    REST endpointPOST https://cotlet.dev/api/v1/hapana/leads/manage

    Parameters

    Parameters: manage_leads
    NameTypeDescription
    action string required string One of `list`, `add`, `assign`, `update`, `delete`. `list` only reads.
    lead string string Lead name, for every action but `add` and `list`.
    fields object object Name, email, phone and lead source (walk-in, referral, Instagram).
    assign_to string string Team member, for `assign`.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "lead": "Example Prospect",
      "source": "Instagram",
      "assigned_to": "Front desk",
      "saved": true
    }
  • send_workout_program Create a workout program and send it to a client or a group. writeAsks first

    The Client Program Log shows each sent program as Pending, Active or Done, and clients can track progress and leave notes on it. Sending reaches the client, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → send_workout_program

    REST endpointPOST https://cotlet.dev/api/v1/hapana/workout-programs

    Parameters

    Parameters: send_workout_program
    NameTypeDescription
    name string required string Program name, for example 6-Week Strength Challenge.
    sections object object Warm-up, workout and cool-down: per exercise its type, name, equipment, reps, sets, rest and resistance.
    send_to string string A client or a client group.

    Example input

    {
      "name": "Jane Doe"
    }

    Example response

    {
      "program": "6-Week Strength Challenge",
      "sent_to": "6 Week Challenge",
      "status": "Pending"
    }

Memberships and packages4

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

  • update_membership_status Suspend, cancel, or reactivate a client's membership. writeAsks first

    A suspension pauses billing and access for its dates. A dated cancellation runs between 00:00 and 4:00 on that date. `active` resumes a suspension and `remove_cancellation` removes a scheduled one, so the client keeps the membership instead of buying a new one. Each change affects what the client pays. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → update_membership_status

    REST endpointPATCH https://cotlet.dev/api/v1/hapana/membership-status

    Parameters

    Parameters: update_membership_status
    NameTypeDescription
    client string required string Client name, email or phone, as find_client returns it.
    membership string required string Membership or package name on the client's profile.
    status string required string One of `suspended`, `cancelled`, `active`, `remove_cancellation`.
    start_date string string ISO date it takes effect. Empty means immediately.
    end_date string string For `suspended`: ISO date it ends. Empty means until resumed.
    reason string string For `cancelled`: a cancellation reason from your list.

    Example input

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

    Example response

    {
      "client": "Example Member",
      "membership": "Unlimited Monthly",
      "status": "suspended",
      "start_date": "2026-11-20",
      "end_date": "2026-12-20"
    }
  • update_package_credits Add or deduct credits on a client's package, or move its credit expiry date. writeAsks first

    Changes apply at once and show in the package history, and the client can book with the new balance. Useful for make-goods, bonus sessions and clients back from injury or travel. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → update_package_credits

    REST endpointPATCH https://cotlet.dev/api/v1/hapana/package-credits

    Parameters

    Parameters: update_package_credits
    NameTypeDescription
    client string required string Client name, email or phone, as find_client returns it.
    membership string required string Membership or package name on the client's profile.
    credits integer integer Credits to add; negative to deduct.
    valid_until string string New credit expiry, ISO date. Packages only, not memberships.

    Example input

    {
      "client": "client",
      "membership": "membership"
    }

    Example response

    {
      "client": "Example Member",
      "package": "10 Class Pack",
      "credits_before": 3,
      "credits_after": 5,
      "valid_until": "2027-01-15"
    }
  • edit_future_payments Change the rate of future membership payments for one client or many. writeAsks first

    Uses Bulk Edit Future Transactions in the Retail Dashboard, or a single client's membership. The agent lists every matching transaction and its current rate before it saves, because members will be charged the new rate. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → edit_future_payments

    REST endpointPATCH https://cotlet.dev/api/v1/hapana/future-payments

    Parameters

    Parameters: edit_future_payments
    NameTypeDescription
    client string string One client. Leave empty for a bulk edit.
    memberships array array For a bulk edit: memberships, or a client group.
    from string required string ISO date, first payment to change.
    to string required string ISO date, last payment to change.
    new_rate number required number New payment amount.

    Example input

    {
      "from": "from",
      "to": "to",
      "new_rate": 1
    }

    Example response

    {
      "transactions": 42,
      "from": "2026-12-01",
      "to": "2026-12-31",
      "old_rate": 49,
      "new_rate": 54,
      "saved": true
    }
  • send_package_agreement Send a client the agreement of a package or membership to sign on their own device. writeAsks first

    The package must have Package Agreement switched on with its text in Retail Configurations, and the client needs a mobile number or email on file. The link reaches the client, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → send_package_agreement

    REST endpointPOST https://cotlet.dev/api/v1/hapana/package-agreements

    Parameters

    Parameters: send_package_agreement
    NameTypeDescription
    client string required string Client name, email or phone, as find_client returns it.
    membership string required string Membership or package name on the client's profile.

    Example input

    {
      "client": "client",
      "membership": "membership"
    }

    Example response

    {
      "client": "Example Member",
      "package": "Unlimited Monthly",
      "agreement_sent_to": "member@example.com"
    }

Sales and payments4

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

  • process_sale Sell a membership, package, product, gift card or custom charge to a client. writeAsks first

    The New Sale screen of Payments. A sale charges the client, so the agent shows the cart, client and method before it pays. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → process_sale

    REST endpointPOST https://cotlet.dev/api/v1/hapana/sale/process

    Parameters

    Parameters: process_sale
    NameTypeDescription
    client string required string Client name, email or phone, as find_client returns it.
    item_type string required string One of `single_payment`, `recurring_payment`, `session_package`, `membership`, `product`, `gift_card`.
    item string string The configured item, or for `single_payment` a description and price.
    discount number number Discount on the item.
    payment_method string string Account credit, or the card on file through Pay Securely.
    gift_card object object For `gift_card`: design, to and from names, purchaser and recipient email, message, delivery date.

    Example input

    {
      "client": "client",
      "item_type": "item type"
    }

    Example response

    {
      "client": "Example Member",
      "item": "10 Class Pack",
      "total": 180,
      "payment_method": "card on file",
      "paid": true
    }
  • membership_payment Refund a payment from a membership's history, or collect a pending one. writeAsks first

    Refunds go to the original payment method, as Hapana recommends, never to cash or account credit unless you say so. `collect` charges a pending payment from the Payment Schedule so the membership stays active. Both move money. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → membership_payment

    REST endpointPOST https://cotlet.dev/api/v1/hapana/payment/membership

    Parameters

    Parameters: membership_payment
    NameTypeDescription
    client string required string Client name, email or phone, as find_client returns it.
    membership string required string Membership or package name on the client's profile.
    action string required string One of `refund`, `collect`.
    amount number number For `refund`: full or partial amount, as your gateway allows.
    payment_date string string ISO date of the payment.

    Example input

    {
      "client": "client",
      "membership": "membership",
      "action": "action"
    }

    Example response

    {
      "client": "Example Member",
      "membership": "Unlimited Monthly",
      "action": "refund",
      "amount": 49,
      "method": "original card",
      "done": true
    }
  • charge_no_show_fee Charge the no-show fee to clients who missed a finished class. writeAsks first

    Available once the class is complete, for booked clients not marked attending; the fee comes from your Retail Settings. The agent lists the eligible clients and the fee before it charges. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → charge_no_show_fee

    REST endpointPOST https://cotlet.dev/api/v1/hapana/no-show-fee/charge

    Parameters

    Parameters: charge_no_show_fee
    NameTypeDescription
    session string required string Session name and start, as list_sessions returns it.
    clients array array Clients to charge. Empty means every eligible no-show.

    Example input

    {
      "session": "session"
    }

    Example response

    {
      "session": "Kickboxing, 2026-11-14 18:00",
      "charged": [
        "Example Member"
      ],
      "fee": 15
    }
  • send_invoice_email Find a client's invoice and email a copy. writeAsks first

    Uses Send Invoice Email in the Payments section of the client profile. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → send_invoice_email

    REST endpointPOST https://cotlet.dev/api/v1/hapana/invoice-emails

    Parameters

    Parameters: send_invoice_email
    NameTypeDescription
    client string required string Client name, email or phone, as find_client returns it.
    invoice string required string Invoice date or number from the client's payments.
    email string string Send to another address. Default the client's email.

    Example input

    {
      "client": "client",
      "invoice": "invoice"
    }

    Example response

    {
      "client": "Example Member",
      "invoice": "2026-11-01",
      "sent_to": "member@example.com"
    }

Schedule and bookings6

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

  • list_sessions Read classes for a date range with instructor, capacity, bookings and waitlist. read

    Reads the Schedule tab. Returns each session with its booked clients, capacity and waitlist. It changes nothing.

    MCP callhapana_read → list_sessions

    REST endpointGET https://cotlet.dev/api/v1/hapana/sessions

    Parameters

    Parameters: list_sessions
    NameTypeDescription
    from string required string ISO date.
    to string string ISO date. Default: same day.
    name string string Filter by class name.

    Example input

    {
      "from": "from"
    }

    Example response

    {
      "sessions": [
        {
          "session": "Reformer Flow, 2026-11-16 07:00",
          "instructor": "Instructor A",
          "booked": 12,
          "capacity": 12,
          "waitlist": 2
        },
        {
          "session": "Kickboxing, 2026-11-16 18:00",
          "instructor": "Instructor B",
          "booked": 9,
          "capacity": 16,
          "waitlist": 0
        }
      ]
    }
  • add_session Add a class to the schedule, once or recurring, paid or free. writeAsks first

    Hapana advises setting up each weekday separately so later edits do not change other days by accident; the agent creates one session series per day. Clients can book once it is on the schedule. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → add_session

    REST endpointPOST https://cotlet.dev/api/v1/hapana/sessions

    Parameters

    Parameters: add_session
    NameTypeDescription
    template string required string Schedule template, for example Yoga Flow.
    start string required string ISO date and time of the first session.
    days array array Weekdays it recurs on.
    end_date string string Last date. Empty for ongoing.
    instructors array required array One or more instructors.
    free boolean boolean Credit Required 0, Drop-in Price 0.00, Payment Required No.

    Example input

    {
      "template": "template",
      "start": "start",
      "instructors": "instructors"
    }

    Example response

    {
      "template": "Yoga Flow",
      "start": "2026-11-17T07:00",
      "days": [
        "Monday"
      ],
      "instructors": [
        "Instructor A"
      ],
      "free": false,
      "saved": true
    }
  • book_client Book a member or a client group into a class, or onto its waitlist when full. writeAsks first

    For members who call in or ask at the desk. When the class is full and its template has a waitlist, the client joins the waitlist and moves in automatically, in order, when someone cancels. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → book_client

    REST endpointPOST https://cotlet.dev/api/v1/hapana/clients/book-client

    Parameters

    Parameters: book_client
    NameTypeDescription
    session string required string Session name and start, as list_sessions returns it.
    client string string A client.
    group string string Or a client group.

    Example input

    {
      "session": "session"
    }

    Example response

    {
      "session": "Reformer Flow, 2026-11-16 07:00",
      "client": "Example Member",
      "result": "waitlisted",
      "position": 3
    }
  • check_in_client Mark a booked client as attended, today or for a past session. writeAsks first

    Attendance shows in reports and applies the session credit. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → check_in_client

    REST endpointPOST https://cotlet.dev/api/v1/hapana/client/check

    Parameters

    Parameters: check_in_client
    NameTypeDescription
    client string required string Client name, email or phone, as find_client returns it.
    session string required string Session name and start, as list_sessions returns it.

    Example input

    {
      "client": "client",
      "session": "session"
    }

    Example response

    {
      "client": "Example Member",
      "session": "Kickboxing, 2026-11-14 18:00",
      "attended": true
    }
  • change_instructor Put a substitute on a class, or change its primary instructor. writeAsks first

    Substitutes are recorded separately in payroll, so pick `substitute` when the regular instructor is only away. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → change_instructor

    REST endpointPATCH https://cotlet.dev/api/v1/hapana/instructor

    Parameters

    Parameters: change_instructor
    NameTypeDescription
    session string required string Session name and start, as list_sessions returns it.
    instructor string required string A team member.
    as string required string `substitute` for a one-off, `instructor` for a permanent change.

    Example input

    {
      "session": "session",
      "instructor": "instructor",
      "as": "as"
    }

    Example response

    {
      "session": "Kickboxing, 2026-11-21 18:00",
      "instructor": "Instructor C",
      "as": "substitute",
      "saved": true
    }
  • bulk_cancel_sessions Cancel every session in a date range except the ones you keep. writeAsks first

    Hapana has no undo for this, so the agent lists every session it will cancel and waits. It saves the CSV record Hapana downloads. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → bulk_cancel_sessions

    REST endpointPOST https://cotlet.dev/api/v1/hapana/cancel-sessions/bulk

    Parameters

    Parameters: bulk_cancel_sessions
    NameTypeDescription
    from string required string ISO date.
    to string required string ISO date.
    keep array array Sessions to leave on the schedule.

    Example input

    {
      "from": "from",
      "to": "to"
    }

    Example response

    {
      "from": "2026-12-24",
      "to": "2026-12-26",
      "cancelled": 11,
      "kept": 1,
      "csv": "cancelled-sessions.csv"
    }

Studio setup and retail5

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

  • manage_schedule_templates List, create, edit or delete schedule templates and their session types. writeAsks first

    Session types link classes to the memberships and packs that may book them. A deleted template cannot be scheduled again. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → manage_schedule_templates

    REST endpointPOST https://cotlet.dev/api/v1/hapana/schedule-templates/manage

    Parameters

    Parameters: manage_schedule_templates
    NameTypeDescription
    action string required string One of `list`, `create`, `update`, `delete`. `list` only reads.
    template string string Template name, for example Boxing.
    session_type string string Session type; a new one is created with a colour.
    fields object object Description, duration, credits, payment and attendance settings, waitlist limit.
    apply_to_future_sessions boolean boolean For `update`: also change every future session from it.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "template": "Boxing",
      "session_type": "Boxing",
      "duration_minutes": 45,
      "saved": true
    }
  • configure_room Add a room to a location and set when it can be booked. writeAsks first

    A room with no times set does not show on the scheduler and cannot be booked. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → configure_room

    REST endpointPOST https://cotlet.dev/api/v1/hapana/room/configure

    Parameters

    Parameters: configure_room
    NameTypeDescription
    room string required string Room name, for example Cycle Studio.
    availability array array Days and times the room appears on the schedule.
    bookable boolean boolean Assign Room Resource Booking, for spot allocation.
    allow_overlap boolean boolean Allow overlapping sessions.

    Example input

    {
      "room": "room"
    }

    Example response

    {
      "room": "Cycle Studio",
      "bookable": true,
      "allow_overlap": false,
      "saved": true
    }
  • manage_memberships_packages List or create a membership (recurring) or a package (one-time) for sale. writeAsks first

    Retail Configurations in Payments. A new offer with online purchase on appears in your app and on your website, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → manage_memberships_packages

    REST endpointPOST https://cotlet.dev/api/v1/hapana/memberships-packages/manage

    Parameters

    Parameters: manage_memberships_packages
    NameTypeDescription
    action string required string One of `list`, `create`. `list` only reads.
    type string string `membership` or `package`.
    name string string Shown in the app and widgets.
    fields object object Description, categories, billing cycle and length, price, credits, session types, Enable Client Purchase Online.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "type": "package",
      "name": "Intro 3 Class Pass",
      "price": 39,
      "credits": 3,
      "online": true,
      "saved": true
    }
  • manage_promo_codes List or create a percentage or dollar promo code. writeAsks first

    An active code discounts real sales, so the agent shows the discount and limits before saving. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → manage_promo_codes

    REST endpointPOST https://cotlet.dev/api/v1/hapana/promo-codes/manage

    Parameters

    Parameters: manage_promo_codes
    NameTypeDescription
    action string required string One of `list`, `create`. `list` only reads.
    name string string Promo name.
    code string string What clients type, for example HALFPRICE.
    discount object object Percentage or dollar amount, value, and the packages or memberships it applies to.
    limits object object Start date, optional end date and total usage limit.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "name": "January intro",
      "code": "NEWYEAR20",
      "discount": "20%",
      "applies_to": "Packages",
      "ends": "2027-01-31",
      "saved": true
    }
  • manage_pos_products Add, edit or remove a product in POS Inventory. writeAsks first

    Products need a POS category; a variable takes a barcode or a SKU, not both. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → manage_pos_products

    REST endpointPOST https://cotlet.dev/api/v1/hapana/pos-products/manage

    Parameters

    Parameters: manage_pos_products
    NameTypeDescription
    action string required string One of `list`, `create`, `update`, `remove`. `list` only reads.
    product string string Product name.
    variables array array Per size or colour: name, price, tax setting, barcode or SKU (one of them), track stock, stock count, online purchase.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "product": "Studio T-shirt",
      "variables": [
        {
          "name": "White Small",
          "price": 35,
          "stock": 12
        }
      ],
      "saved": true
    }

Messages and marketing4

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

  • send_bulk_message Send an email, SMS or push notification to clients or a group in CORE. writeAsks first

    SMS uses your SMS credits. A message reaches every recipient at once, so the agent shows the audience size and text first. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → send_bulk_message

    REST endpointPOST https://cotlet.dev/api/v1/hapana/bulk-messages

    Parameters

    Parameters: send_bulk_message
    NameTypeDescription
    to string required string Clients, a group, or the booked or waitlisted clients of a session.
    channel string required string `email`, `sms` or `push`.
    message string required string The message.

    Example input

    {
      "to": "to",
      "channel": "channel",
      "message": "message"
    }

    Example response

    {
      "to": "6 Week Challenge",
      "channel": "push",
      "recipients": 18,
      "sent": true
    }
  • send_email_campaign Send or schedule a GROW email campaign from a template. writeAsks first

    Needs a verified sending domain in your location. The agent shows recipients, subject and send time before it schedules. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → send_email_campaign

    REST endpointPOST https://cotlet.dev/api/v1/hapana/email-campaigns

    Parameters

    Parameters: send_email_campaign
    NameTypeDescription
    template string required string Saved email template.
    recipients string required string Smart List, tags or selected contacts.
    subject string string Default from the template.
    send_at string string ISO date and time; empty sends now.

    Example input

    {
      "template": "template",
      "recipients": "recipients"
    }

    Example response

    {
      "campaign": "December timetable",
      "recipients": 640,
      "send_at": "2026-11-28T09:00",
      "scheduled": true
    }
  • send_bulk_sms Text a filtered list of GROW contacts, personalised with custom values. writeAsks first

    Needs an SMS number on the location, enough SMS credits and contacts opted in to SMS. The agent selects every matching record, not only the 20 on the first page. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → send_bulk_sms

    REST endpointPOST https://cotlet.dev/api/v1/hapana/bulk-sms

    Parameters

    Parameters: send_bulk_sms
    NameTypeDescription
    contacts string required string Smart List or filter.
    message string required string Text with custom values, for example the first name.

    Example input

    {
      "contacts": "contacts",
      "message": "message"
    }

    Example response

    {
      "contacts": "Lapsed 60 days",
      "recipients": 85,
      "sent": true
    }
  • import_export_contacts Export filtered contacts to CSV, or import a CSV of contacts. writeAsks first

    An import can also bring Opportunities. Exports include the custom fields you choose. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → import_export_contacts

    REST endpointPOST https://cotlet.dev/api/v1/hapana/export-contacts

    Parameters

    Parameters: import_export_contacts
    NameTypeDescription
    action string required string One of `export`, `import`. `export` only reads.
    filter string string For `export`: Smart List, tag or date added.
    file_url string string For `import`: a .csv under 30 MB, one tab, headers in row one.
    mode string string For `import`: `add_new` or `update_existing`; empty values never overwrite.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "action": "export",
      "filter": "Tag: trial",
      "contacts": 37,
      "file": "contacts.csv"
    }

Staff time and reports2

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

  • add_time_clock_entry Record a shift a team member forgot to clock. writeAsks first

    Needs an Admin or Manager login. Entries feed the payroll report, so times are checked with you before saving. By default you confirm each call; you can switch that off for this tool.

    MCP callhapana_write → add_time_clock_entry

    REST endpointPOST https://cotlet.dev/api/v1/hapana/time-clock-entries

    Parameters

    Parameters: add_time_clock_entry
    NameTypeDescription
    team_member string required string Staff member.
    date string required string ISO date.
    start string required string Start time.
    end string required string End time.
    notes string string Internal note.

    Example input

    {
      "team_member": "team member",
      "date": "date",
      "start": "start",
      "end": "end"
    }

    Example response

    {
      "team_member": "Front desk A",
      "date": "2026-11-13",
      "start": "09:00",
      "end": "13:00",
      "saved": true
    }
  • get_report Run the payroll report or the member delinquency report. read

    Payroll returns per team member the session count, hours from sessions and time clock, and earnings by rate. Delinquency by member returns each member once with oldest unpaid invoice age, past-due balance and payment method. It changes nothing.

    MCP callhapana_read → get_report

    REST endpointGET https://cotlet.dev/api/v1/hapana/report

    Parameters

    Parameters: get_report
    NameTypeDescription
    report string required string One of `payroll`, `delinquency_by_member`, `delinquency_invoice_summary`, `delinquency_invoice_detailed`.
    from string string Payroll: ISO date.
    to string string Payroll: ISO date.
    team_member string string Payroll: one staff member, empty for all.

    Example input

    {
      "report": "report"
    }

    Example response

    {
      "report": "delinquency_by_member",
      "members": [
        {
          "member": "Example Member",
          "delinquency_age_days": 34,
          "invoices": 2,
          "past_due": 98
        },
        {
          "member": "Sample Member",
          "delinquency_age_days": 12,
          "invoices": 1,
          "past_due": 49
        }
      ]
    }
Encrypted, revocable

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

We keep it working

What happens when Hapana changes? The tools follow the CORE and GROW screens your desk staff use.

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.

28 tools ask first

Approvals, undo and mistakes Members are charged or messaged only after your OK.

  1. 01 Read the class list_sessions after it ends.
  2. 02 Find the no-shows Booked, not marked attending.
  3. 03 Show you names and fee Nothing is charged yet.
  4. 04 Charge after your OK charge_no_show_fee runs.
Fixing a Hapana write that went wrong
ActionHow to put it right
Suspension or scheduled cancellationupdate_membership_status with active or remove_cancellation
Package credits or expiryCall update_package_credits again with the earlier numbers
Fee or sale chargedRefund it with membership_payment to the original method
Bulk cancelled sessionsNo undo in Hapana: add them back with add_session
Message or campaign sentAlready 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.

Pay per call

How much does the Hapana MCP server cost?

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

Illustrative month, our assumption: successful calls for this workload
JobCallsCredits
Morning schedule read1 × 30300
Bookings and waitlist adds for callers1 × 60600
No-show fees after classes1 × 40400
Pending payments collected1 × 20200
Suspensions, cancellations, reactivations1 × 20200
Package credit top-ups and extensions1 × 15150
Instructor substitutions1 × 12120
Weekly member message2 × 480
Payroll and delinquency reports2 × 480
Cloud Browser, 30 days1,500
Total213 calls3,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.

Cotlet credit packs: price, credits and calls at 10 credits each
Credits Price, one time Calls at 10 credits Per 1,000 credits
5,000 $29 500 $5.80
15,000 $79 1,500 $5.27
32,000 $149 3,200 $4.66
60,000 $249 6,000 $4.15

Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header.

Other options

Hapana MCP server: other ways to connect What a studio on Hapana can use, and where each stops.

Other ways to work with Hapana, checked 15 Nov 2026
OptionWhat it doesWhere it stops
Hapana API on ProFull read and write, all webhooks, metered premium actions.Pro plan; you write, host and fix the client.
Hapana API on PremiumRead-only access and read webhooks.No writes: no bookings, charges or membership changes.
Zapier and MiddleHapana's listed connectors for workflow automation.Triggers and steps you build; not an agent working in CORE.
Hapana AssistantQueries the audit log, on Pro.Inside Hapana only, not for ChatGPT or Claude.
By handEvery 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.

EU company, since 2019

Who runs Cotlet A company you can look up.

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.

Hand tonight's no-shows to your agent.

Free 7-day trial with 2,000 credits, no card needed.