PTminder 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., "@PTminder MCP server show me yesterday's sessions that still need reconciling"
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.
PTminder MCP server
Connect PTminder to ChatGPT, Claude and any AI agent through Cotlet.dev. Reconcile sessions, manage bookings, assign workout plans and read client balances in your own signed-in trainer account. Write actions ask for approval by default.
What you can ask
List yesterday's sessions waiting to be reconciled.
Find clients with outstanding balances and draft a reminder for my approval.
Build a workout plan and show it to me before assigning it.
Related MCP server: Gymdesk 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 PTminder 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 ptminder_agent.py serveOr with Docker:
docker build -t ptminder-mcp .
docker run -i --rm -e COTLET_API_KEY ptminder-mcpTools: ptminder_guide, ptminder_status, ptminder_open, ptminder_read, ptminder_click, ptminder_type, ptminder_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 ptminder_agent.py connect # ready config for ChatGPT, Claude, Claude Code and Cursor
python3 ptminder_agent.py status # is PTminder ready in your Cotlet.dev account
python3 ptminder_agent.py guide # PTminder screens and sign-in link
python3 ptminder_agent.py read # open PTminder, read the page, close the browser
python3 ptminder_agent.py tools # list Cotlet.dev tools
python3 ptminder_agent.py serve # start the stdio MCP server (same as no argument)Questions from PTminder users
Which PTminder login should I use?
Sign in with your own trainer account in the Cotlet Cloud Browser, including the verification code if PTminder asks for one.
Do payments and client messages ask for approval?
Write actions, including charges and messages, ask for approval by default.
Is Cotlet affiliated with PTminder?
No. Cotlet.dev is independent and not affiliated with PTminder.
Learn more
Request access: https://cotlet.dev/signup?app=ptminder&utm_source=github&utm_medium=readme&utm_campaign=ptminder
Workflows on the hosted integration
The live integration page documents these 32 operations:
find_clientsget_client_summarylist_client_sessionsadd_clientremove_clientrecord_client_noterecord_client_assessmentbook_sessionset_availabilityset_trainer_rosterreconcile_sessioncreate_workout_planrecord_workoutcreate_nutrition_planassign_packageassign_membershipadjust_service_creditschange_membership_paymentsmanage_recurring_card_paymentsmanage_discount_codesget_store_buy_linkcheck_client_balancescharge_stored_paymentrecord_paymentmanage_invoicesrecord_expenserun_financial_reportrun_general_reportsend_smsshare_documentedit_email_templateedit_signup_form
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 toolsptminder_clickB
Click a numbered element on the current PTminder page.
Inputs: element (required).
ptminder_closeA
Close the PTminder browser session when the work is done, so credits stop running.
Inputs: no named parameters.
ptminder_guideA
How to work in PTminder (clients, sessions, workout plans, packages, payments and reports): its screens and the sign-in link. Call this first.
Inputs: task.
ptminder_openB
Open a PTminder page in your signed-in Cloud Browser (default https://ptminder.com) to work with clients, sessions, workout plans, packages, payments and reports.
Inputs: url.
ptminder_readA
Read the current PTminder page: its text and numbered buttons, links and fields.
Inputs: element.
ptminder_statusB
Check that your Cotlet.dev account and PTminder are ready: account, credits and PTminder connection.
Inputs: no named parameters.
ptminder_typeB
Type text into a numbered field on the current PTminder 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 clearly distinct step in the browser automation loop: guide (instructions), status (account check), open (launch), read (inspect), click (interact), type (input), close (teardown). There is no meaningful overlap, and the descriptions reinforce the sequence. An agent can easily select the right tool.
All seven tools share the ptminder_ prefix and use short snake_case action words. The convention is uniform and readable throughout, with only a trivial noun-vs-verb distinction between guide/status and open/read/click/type/close.
Seven tools is well-scoped for a browser automation server. The set covers the full interaction loop plus onboarding (guide) and account validation (status), with no redundant tools.
The open/read/click/type/close cycle provides a complete CRUD-style interaction loop for working on PTminder pages via a browser. Minor gaps remain, such as scrolling, screenshots, or explicit dropdown-select handling, but an agent can work around these through clicking and reading.
Maintenance
Related MCP Connectors
Access approved FITsociety clients, schedules, bookings and coaching data with AI assistants.
My PT Hub MCP server for ChatGPT, Claude and any AI agent: book session, add client, assign program, create nutrition plan and list clients in your own My PT Hub account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to My PT Hub yourself; Cotlet does not store your password and you need no My PT Hub API key. About the official My PT Hub API: My PT Hub publishes no public API. Its only connection is a Zapier integration sold as an add-on on Premium plans, mostly triggers plus adding clients (checked 8 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/my-pt-hub-api-mcp-server
Manage fitness coaching clients, workouts, programs, chats and funnels from your assistant.
PT Distinction MCP server for ChatGPT, Claude and any AI agent: add client, assign program, add client to group, send form and list clients in your own PT Distinction account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to PT Distinction yourself; Cotlet does not store your password and you need no PT Distinction API key. About the official PT Distinction API: PT Distinction publishes no public API or developer docs. Its only connection is a Zapier app that adds clients, packages and groups and reports new sign-ups (checked 9 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/pt-distinction-api-mcp-server
Related MCP Servers
- AlicenseAqualityBmaintenanceConnects a signed-in Phorest account to AI agents, enabling natural-language appointment booking and rebooking, schedule and gap checks, client history queries, and client-card notes without a Phorest API key.7Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceEnables ChatGPT, Claude, and other AI agents to work with attendance, leads, memberships, and member messages in a signed-in Gymdesk account, including check-ins and approved messaging.Elastic 2.0
- AlicenseAqualityBmaintenanceEnables ChatGPT, Claude, and other AI agents to work with client check-ins, workout templates, and training programs in a user's signed-in account, with approval required before actions reach other people.7Elastic 2.0
- AlicenseAqualityBmaintenanceConnects ChatGPT, Claude, and other AI agents to a signed-in Zenoti account so they can work with appointments, guest conversations, reviews, and reports. Write operations require approval by default.7Elastic 2.0