How to connect PushPress to ChatGPT, Claude and any AI agent
ChatGPT, Claude and other AI agents can work in your PushPress Core account. Cotlet.dev connects your own signed-in PushPress staff account to an agent, workflow or script through hosted MCP and REST.
What you can ask
Which classes have open spots today, and who is on the waitlist?
Check in the members on the 7:00 class roster.
Show no-shows and late cancels for last week.
Pause a member plan while they are away, after I approve it.
Message the class roster, then cancel the class after I approve both steps.
Connect your account
- Create an account at Cotlet.dev and enable PushPress for agents.
- Sign in to PushPress Core with your staff login in Cotlet's Cloud Browser.
- Add
https://cotlet.dev/mcp/v1to your agent. Chat apps sign in with Cotlet.dev; editors and scripts can useCOTLET_API_KEY.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
ChatGPT
Settings -> Apps -> add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No PushPress API key is needed.
Run it locally (stdio)
This repository includes a small stdio MCP server for clients that only start local processes. It forwards calls to the hosted Cotlet.dev service. The hosted URL remains the recommended setup.
{"mcpServers":{"pushpress":{"command":"uvx","args":["pushpress-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
The local server exposes seven browser helpers: pushpress_guide, pushpress_status, pushpress_open, pushpress_read, pushpress_click, pushpress_type and pushpress_close. It lists these tools without a key and forwards authenticated calls to Cotlet.dev. Call pushpress_guide first and close the browser with pushpress_close when finished.
The hosted PushPress connection separately documents 14 operations for classes, rosters, check-ins, members, plans, no-show reports, messages and cancellations. The local package does not expose those 14 operations as its own tool list.
Command line
pip install pushpress-mcp
pushpress-mcp connect
pushpress-mcp status
pushpress-mcp guide
pushpress-mcp tools
pushpress-mcp serve
Keep COTLET_API_KEY in your credential store, never in a shared workflow export.
PushPress tools through Cotlet.dev
The hosted connection works in your Core staff account and includes list_classes, get_class_roster, book_class_reservation, check_in_member, remove_reservation, list_members, get_member, list_plan_templates, switch_member_plan, pause_member_plan, cancel_member_plan, list_no_shows_late_cancels, message_class_registrants and cancel_class.
Six tools that change plans, send messages or cancel classes ask for your approval by default. Booking and check-in can be undone with remove_reservation. Use an admin Core login for plan changes and the No Show / Late Cancel report.
Does PushPress have an API or MCP server?
PushPress publishes a Platform API and an SDK. The Cotlet.dev page documents the staff workflows above through your own signed-in Core account. Cotlet works in your own Core login and is independent from PushPress. It is not affiliated with PushPress, Inc.
Independence
Cotlet.dev is independent and is not affiliated with, endorsed by or sponsored by PushPress, Inc. PushPress is a trademark of its owner.
Read the current workflow reference: https://cotlet.dev/integrations/pushpress-api-mcp-server?utm_source=pypi&utm_medium=package&utm_campaign=pushpress
Source: https://github.com/cotlet-connect/pushpress-mcp
Licensed under Elastic License 2.0; see LICENSE.
Metadata
Release files for pushpress-mcp 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pushpress_mcp-1.1.0.tar.gz | 7.4 kB | Without provenance | Details for pushpress_mcp-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pushpress_mcp-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for pushpress_mcp-1.1.0-py3-none-any.whl |
Total release size: 15.6 kB
Release files / pushpress_mcp-1.1.0.tar.gz
| Download URL | pushpress_mcp-1.1.0.tar.gz |
|---|---|
| Size | 7.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a6c1714ae705eda942a340478a2fa35b754c503dd76151b976a1f1bd796985ce
|
|
BLAKE2b-256 checksum How to use checksums |
01a95a96fc7b9ff27118ee033a82b30ba868d77b11fc361aaaa4af4c7a495c82
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / pushpress_mcp-1.1.0-py3-none-any.whl
| Download URL | pushpress_mcp-1.1.0-py3-none-any.whl |
|---|---|
| Size | 8.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d8df168a712612525eb3d54d9ffbb50ee312ca21fc9cbd4ff342c19d7df166f7
|
|
BLAKE2b-256 checksum How to use checksums |
3017032c9d7e4afb2697abadfdc526b3d7d48cca5af1f85154d2198864fc67f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for pushpress-mcp 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.