Skip to main content

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

  1. Create an account at Cotlet.dev and enable PushPress for agents.
  2. Sign in to PushPress Core with your staff login in Cotlet's Cloud Browser.
  3. Add https://cotlet.dev/mcp/v1 to your agent. Chat apps sign in with Cotlet.dev; editors and scripts can use COTLET_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)

Source distribution for pushpress-mcp 1.1.0
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)

Table of built distributions (wheels) for pushpress-mcp 1.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page