Skip to main content
Glama

Hapana MCP server

Connect Hapana to ChatGPT, Claude and any AI agent through Cotlet.dev. Work in your own CORE and GROW login with 31 hosted operations for clients, memberships, classes, payments and messages. All 28 write operations ask for approval by default.

What you can ask

Show today's classes and their bookings.

Find a member and show their memberships and payments.

Run the member delinquency report.

Related MCP server: GoReminders MCP server

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

ChatGPT

Settings → Apps & Connectors → Create, with connector URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev. No API key needed.

Claude

Settings → Connectors → Add custom connector, with URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev.

Claude Code

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

Cursor

Copy .cursor/mcp.json from this repo into your project:

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Hapana tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Run the included Python module with Python 3.10 or later:

python3 hapana_agent.py serve

Or with Docker:

docker build -t hapana-mcp .
docker run -i --rm -e COTLET_API_KEY hapana-mcp

Tools: hapana_guide, hapana_status, hapana_open, hapana_read, hapana_click, hapana_type, hapana_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, with no third-party runtime dependencies. Clone this repository and run:

export COTLET_API_KEY="your-key"
python3 hapana_agent.py connect   # ready config for ChatGPT, Claude, Claude Code and Cursor
python3 hapana_agent.py status    # is Hapana ready in your Cotlet.dev account
python3 hapana_agent.py guide     # Hapana screens and sign-in link
python3 hapana_agent.py read      # open Hapana, read the page, close the browser
python3 hapana_agent.py tools     # list Cotlet.dev tools
python3 hapana_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from Hapana users

Which Hapana login should I use?

Use your own CORE login with the permissions needed for the task. Add GROW in the same Cloud Browser for campaigns, bulk SMS and contact import or export.

Which operations ask for approval?

All 28 write operations ask for approval by default. The three read operations find clients, list sessions and run reports.

Is Cotlet affiliated with Hapana?

No. Cotlet.dev is independent and not affiliated with Hapana.

Learn more


More: https://cotlet.dev/integrations/hapana-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=hapana

Request access: https://cotlet.dev/signup?app=hapana&utm_source=github&utm_medium=readme&utm_campaign=hapana

Workflows on the hosted integration

The live integration page documents these 31 operations:

  • find_client

  • add_client

  • merge_clients

  • manage_client_groups

  • manage_leads

  • send_workout_program

  • update_membership_status

  • update_package_credits

  • edit_future_payments

  • send_package_agreement

  • process_sale

  • membership_payment

  • charge_no_show_fee

  • send_invoice_email

  • list_sessions

  • add_session

  • book_client

  • check_in_client

  • change_instructor

  • bulk_cancel_sessions

  • manage_schedule_templates

  • configure_room

  • manage_memberships_packages

  • manage_promo_codes

  • manage_pos_products

  • send_bulk_message

  • send_email_campaign

  • send_bulk_sms

  • import_export_contacts

  • add_time_clock_entry

  • get_report

The local stdio adapter exposes seven browser helpers listed above. These helpers forward to Cotlet.dev; the workflow operations are documented on the hosted integration page.

Available Tools

7 tools
hapana_clickC

Click a numbered element on the current Hapana page.

Inputs: element (required).

hapana_closeA

Close the Hapana browser session when the work is done, so credits stop running.

Inputs: no named parameters.

hapana_guideA

How to work in Hapana (manage studio clients, memberships, bookings and payments): its screens and the sign-in link. Call this first.

Inputs: task.

hapana_openB

Open a Hapana page in your signed-in Cloud Browser (default https://core.hapana.com) to work with manage studio clients, memberships, bookings and payments.

Inputs: url.

hapana_readB

Read the current Hapana page: its text and numbered buttons, links and fields.

Inputs: element.

hapana_statusA

Check that your Cotlet.dev account and Hapana are ready: account, credits and Hapana connection.

Inputs: no named parameters.

hapana_typeB

Type text into a numbered field on the current Hapana page.

Inputs: text (required), element (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct step in a browser-automation workflow: guide (instructions), status (account/connection readiness), open (launch session/page), read (inspect page), click (act on element), type (fill field), close (end session). There is no meaningful overlap, and the numbered-element convention in read/click/type reinforces clear boundaries.

    Naming Consistency4/5

    All tools share a consistent hapana_ prefix with short, lowercase names, making the set easy to scan. Minor deviation: guide and status are nouns while open/read/click/type/close are verbs, but the pattern remains predictable.

    Tool Count5/5

    Seven tools is well-scoped for a guided browser-automation server: a setup pair (guide, status), a session lifecycle (open, close), and page primitives (read, click, type). No tool feels redundant or missing from the core loop.

    Completeness4/5

    The surface covers the essential loop of opening a page, inspecting it, interacting via clicks and typing, and closing the session, with guidance and status checks included. Minor gaps exist for common web actions like scrolling, selecting dropdown options, or pressing keys (e.g., Enter to submit), but these can often be worked around via click/type.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Zen Planner MCP server for ChatGPT, Claude and any AI agent: list members, book class, record attendance, enroll in membership and list failed payments in your own Zen Planner account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Zen Planner yourself; Cotlet does not store your password and you need no Zen Planner API key. About the official Zen Planner API: Yes, but only for partners: Zen Planner has an API on the Daxko Partners portal, and its docs say "Contact your Daxko sales representative to request access" (checked 11 Oct 2026). Studios cannot create a key themselves in Zen Planner Studio. Setup and FAQ: https://cotlet.dev/integrations/zen-planner-api-mcp-server

    • PushPress MCP server for ChatGPT, Claude and any AI agent: list members, book class reservation, check in member, cancel reservation and update membership plan in your own PushPress account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to PushPress yourself; Cotlet does not store your password and you need no PushPress API key. About the official PushPress API: PushPress has a Platform API and an SDK that doubles as a local MCP server, both using an API key from Settings > Security & Access, but they are mostly read-only beyond creating customers and invitations (checked 11 Oct 2026). Booking, check-ins, plan changes and class cancellations are done by staff in Core. Setup and FAQ: https://cotlet.dev/integrations/pushpress-api-mcp-server

    • Mariana Tek MCP server for ChatGPT, Claude and any AI agent: list classes, book reservation, cancel reservation, find customer and add class credits in your own Mariana Tek account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Mariana Tek yourself; Cotlet does not store your password and you need no Mariana Tek API key. About the official Mariana Tek API: Yes, but gated: Mariana Tek has APIs (Customer, Studio, Admin, Webhooks and more), and credentials go only to integration partners who sign the Developer Tools Terms of Service and to developers working with a single studio, with the studio owner included in the request; no official MCP server exists (checked 11 Oct 2026). A technical review of about 1 to 3 weeks may follow, and reporting data and Stripe data are not available through the API. Setup and FAQ: https://cotlet.dev/integrations/mariana-tek-api-mcp-server

    • Mindbody MCP server for ChatGPT, Claude and any AI agent: list classes, get class roster, search clients, get client visits, list client contracts, book client into class, cancel client booking and add client in your own Mindbody account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Mindbody yourself; Cotlet does not store your password and you need no Mindbody API key. About the official Mindbody API: Yes. Mindbody has a Public API v6, but it is for approved developers, each studio owner must activate access for their site, and it has no official MCP server (checked 5 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/mindbody-api-mcp-server

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Connects AestheticsPro accounts to ChatGPT, Claude, and other AI agents through Cotlet, enabling appointment scheduling, client contact access, lead creation, and staff assignment with user approval.
      7
      Elastic 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Connects a signed-in GoReminders account to ChatGPT, Claude, and other AI agents through Cotlet.dev, letting them read appointments and customer replies, manage reminders, and review booking requests, with write operations requiring approval before they run.
      7
      Elastic 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Connects a signed-in SalonBiz account to ChatGPT, Claude, Codex, and Claude Code via Cotlet.dev, enabling users to read appointments, tickets, inventory, payments, and reports and to make booking, online booking, and campaign changes with approval by default.
      7
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects Fitsly coach accounts to ChatGPT, Claude, and AI agents through Cotlet.dev, exposing hosted tools for clients, training, nutrition, habits, messages, and packages with approval-gated write actions.
      Elastic 2.0