Skip to main content
Glama
README.md
# Goldie MCP server through Cotlet.dev

Connect Goldie to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Work with salon bookings, clients, services, payments and messages in your own signed-in Goldie account.

Unofficial integration, not affiliated with Goldie. Cotlet.dev hosts the connection through your Cloud Browser. This repository includes an optional Python stdio MCP bridge.

## Connect your salon

1. [Request access to Goldie](https://cotlet.dev/signup?app=goldie).
2. Open https://app.heygoldie.com/ in your Cotlet.dev Cloud Browser and sign in yourself. Enable Goldie for agents.
3. Connect your agent below. Refresh the connector if you enabled Goldie after connecting.

### ChatGPT

Open Settings > Apps & Connectors > Create. Set the MCP server URL to `https://cotlet.dev/mcp/v1/connect` and choose OAuth.

### Claude

Open Settings > Connectors > Add custom connector and enter `https://cotlet.dev/mcp/v1/connect`.

### Codex

Create a Cotlet.dev API key in the console and set `COTLET_API_KEY` in your environment:

```toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

### Claude Code

```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```

## Salon workflows

Examples based on the [live Goldie reference](https://cotlet.dev/integrations/goldie-api-mcp-server):

- Read today's calendar and prepare a booking with the client's chosen service.
- Show the old and new appointment slots before approving a move.
- Review the client, amount and method before taking a deposit or balance.
- List a payment's transactions and approve a partial refund.
- Prepare an offer for quiet slots and review recipients before sending it.
- Update a service's price, duration or online booking availability.

The live reference describes nine hosted capabilities under `goldie_read` and `goldie_write`:

| Capability | Access | Purpose |
|---|---|---|
| `manage_appointments` | write | List or get appointments, or create a booking |
| `reschedule_appointment` | write | Move an appointment to another day or time |
| `manage_clients` | write | List or open clients, or create a record |
| `manage_services` | write | List services, create one or update its details |
| `set_online_booking` | write | Read or change the online booking switch |
| `take_client_payment` | write | Take a deposit or the remaining balance |
| `refund_client_payment` | write | List transactions or refund all or part of a payment |
| `send_mass_message` | write | Read message history or send to a group |
| `export_goldie_data` | read | Request Goldie's emailed ZIP export |

Eight capabilities are classed as write and one as read. Supported `list`, `get` and `history` actions only read. Write tools ask for confirmation by default, configurable per tool. Review the client, amount, recipients and appointment details before approval.

Rescheduling automatically notifies the client. Payments and refunds require Goldie Payments and the corresponding user permissions. Mass messages need Pro or Pro Plus and Goldie's messaging service in a supported country. An already-sent message requires a correction. The export arrives by email in about 15 minutes, its link expires after seven days, and on Pro Plus only the Account Owner can export.

## Optional local stdio bridge

Python 3.10 or newer, with no runtime dependencies. Clone this repository and configure a client supporting stdio:

```json
{"mcpServers":{"goldie":{"command":"python3","args":["/absolute/path/to/goldie-mcp/goldie_agent.py"],"env":{"COTLET_API_KEY":"your-cotlet-key"}}}}
```

The bridge exposes seven browser helpers: `goldie_guide`, `goldie_status`, `goldie_open`, `goldie_read`, `goldie_click`, `goldie_type` and `goldie_close`. They forward to shared Cotlet.dev browser tools and are separate from the nine hosted workflow capabilities above. Call the guide first and close the browser when finished. Discovery works without a key; tool execution requires your Cotlet.dev key and connected Goldie account.

```bash
python3 goldie_agent.py connect
python3 goldie_agent.py guide
python3 goldie_agent.py status
python3 goldie_agent.py serve
```

You can build the included Dockerfile and pass `COTLET_API_KEY` through the environment.

## Reference and access

- [Goldie connection guide and operation reference](https://cotlet.dev/integrations/goldie-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=goldie)
- [Request access](https://cotlet.dev/signup?app=goldie)
- [Cotlet.dev console](https://cotlet.dev/app)

Licensed under Elastic License 2.0. See LICENSE.