Hapana MCP server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hapana MCP server Show today's classes and their bookings."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 serveOr with Docker:
docker build -t hapana-mcp .
docker run -i --rm -e COTLET_API_KEY hapana-mcpTools: 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
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_clientadd_clientmerge_clientsmanage_client_groupsmanage_leadssend_workout_programupdate_membership_statusupdate_package_creditsedit_future_paymentssend_package_agreementprocess_salemembership_paymentcharge_no_show_feesend_invoice_emaillist_sessionsadd_sessionbook_clientcheck_in_clientchange_instructorbulk_cancel_sessionsmanage_schedule_templatesconfigure_roommanage_memberships_packagesmanage_promo_codesmanage_pos_productssend_bulk_messagesend_email_campaignsend_bulk_smsimport_export_contactsadd_time_clock_entryget_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 toolshapana_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
Scored across 7 tools
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.
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.
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.
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
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
- AlicenseAqualityBmaintenanceConnects 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.7Elastic 2.0
- AlicenseAqualityCmaintenanceConnects 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.7Elastic 2.0
- AlicenseAqualityBmaintenanceConnects 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.7Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceConnects 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