# Club OS MCP server for ChatGPT and Claude

Connect Club OS to ChatGPT, Claude and other AI agents through Cotlet. Work with prospects, tour appointments and staff follow-ups in your own signed-in account. Cotlet is independent and not affiliated with Club OS. If Club OS offers an official API for your needs, we recommend it.

## What you can ask

> Show the prospects and follow-ups assigned to my staff member.

> Prepare a tour appointment at the time I choose and ask me before saving.

> Create a prospect from the contact details I provide, with my chosen follow-up person and source. Ask me before saving.

## Connect in 2 minutes

Request access at https://cotlet.dev/signup?app=club-os. For the command line or local server, get your API key from your Cotlet console and export it as `COTLET_API_KEY`.

### ChatGPT

Settings → Apps → add connector URL `https://cotlet.dev/mcp/v1`, then sign in with Cotlet.dev. No API key needed.

### Claude

Add `https://cotlet.dev/mcp/v1` as a custom connector in Claude and sign in with Cotlet.

### Claude Code

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

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

```json
{"mcpServers":{"club-os":{"command":"python3","args":["/absolute/path/to/club_os_agent.py","serve"],"env":{"COTLET_API_KEY":"your-key"}}}}
```

Or with Docker:

```bash
docker build -t club-os-mcp .
docker run -i --rm -e COTLET_API_KEY club-os-mcp
```

Tools: `club_os_guide`, `club_os_status`, `club_os_open`, `club_os_read`, `club_os_click`, `club_os_type`, `club_os_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+, nothing else to install. From this repo:

```bash
export COTLET_API_KEY="your-key"
python3 club_os_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 club_os_agent.py status    # is Club OS ready in your Cotlet.dev account
python3 club_os_agent.py guide     # Club OS screens and sign-in link
python3 club_os_agent.py read      # open Club OS, read the page, close the browser
python3 club_os_agent.py tools     # list Cotlet.dev tools
python3 club_os_agent.py serve     # start the stdio MCP server (same as no argument)
```

## Questions from Club OS users

**How do I connect Club OS to ChatGPT or Claude?**

Sign up at cotlet.dev, log in to Club OS once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Club OS account through Cotlet, in their phone apps too.

**Can ChatGPT add a prospect in Club OS?**

ChatGPT creates the prospect with the follow-up person, origin and marketing source you give it, after you approve it, so a walk-in or phone inquiry lands in your Club OS pipeline.

**Can ChatGPT book a tour in Club OS?**

ChatGPT adds the tour or personal training appointment to the staff member's or prospect's Club OS calendar after you approve it; Club OS emails the attendees.

**Can ChatGPT reassign follow-ups in Club OS?**

ChatGPT moves some or all membership and PT follow-ups from one employee to others, spread evenly, so nobody's prospects are left waiting.

**Is Cotlet affiliated with Club OS?**

No. Cotlet is independent and not affiliated with Club OS.

## Find it on

- [Club OS on Cotlet](https://cotlet.dev/integrations/club-os-api-mcp-server)
- [All Cotlet packages](https://github.com/cotlet-connect)

---

More: https://cotlet.dev/integrations/club-os-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=club-os

Request access: https://cotlet.dev/signup?app=club-os&utm_source=github&utm_medium=readme&utm_campaign=club-os