Metadata-Version: 2.4
Name: pushpress-mcp
Version: 1.1.0
Summary: Connect PushPress to ChatGPT, Claude and other AI agents through Cotlet.dev. Includes a local stdio MCP bridge.
Author-email: Cotlet.dev <contact@cotlet.dev>
Requires-Python: >=3.10
License-Expression: Elastic-2.0
License-File: LICENSE
Description-Content-Type: text/markdown
Keywords: pushpress,pushpress api,pushpress mcp,mcp server,claude,chatgpt,ai agent,cotlet
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business
Project-URL: Homepage, https://cotlet.dev/integrations/pushpress-api-mcp-server?utm_source=pypi&utm_medium=package&utm_campaign=pushpress
Project-URL: Source, https://github.com/cotlet-connect/pushpress-mcp

# 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](https://cotlet.dev/signup?app=pushpress) 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

```bash
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.

```json
{"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

```bash
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.
