Covered Beauty MCP Server
README.md
# Covered Beauty MCP server through Cotlet.dev
Connect Covered Beauty to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Ask your agent to check tomorrow's diary, find unsigned consultation forms and prepare treatment or opening-hour changes in your own signed-in salon account.
Unofficial integration, not affiliated with Covered Beauty. 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 Covered Beauty](https://cotlet.dev/signup?app=covered-beauty).
2. Open https://beauty.covered.technology/login in your Cotlet.dev Cloud Browser and sign in yourself, by password or email code. Enable Covered Beauty for agents.
3. Connect your agent below. Refresh the connector if you enabled Covered Beauty 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 from the [Covered Beauty integration reference](https://cotlet.dev/integrations/covered-beauty-api-mcp-server):
- Check tomorrow's bookings and list clients whose linked forms are incomplete.
- Prepare private form links, review the clients and forms, then approve sending.
- Turn a pasted price list into treatments with durations, prices and deposits.
- Review opening hours before approving a change.
- Brief yourself on a client's visits, notes and signed-form dates.
- Export your salon records.
The live reference describes eight hosted capabilities, grouped under `covered_beauty_read` and `covered_beauty_write`:
| Capability | Access | Purpose |
|---|---|---|
| `manage_treatments` | write | List, create or update treatments, durations, prices and deposits |
| `set_working_hours` | write | Read or change appointment availability |
| `view_diary` | read | Read day or week bookings, deposits and form completion |
| `get_booking_link` | read | Get your client booking page URL |
| `manage_client_records` | write | Find or create clients, read records or add a note |
| `send_form_link` | write | Send or cancel a private consultation-form link |
| `manage_forms` | write | List, enable a named form or link it to treatments |
| `export_records` | read | Download the records export produced by Covered Beauty |
Three capabilities are read and five are write. Supported `list` and `get` actions only read. Writes ask for confirmation by default, configurable per tool. Treatment prices, deposits and opening hours affect what clients can book. Review them before approving.
A form link can contain up to 10 forms and lasts 14 days. Sending a fresh link replaces the old one; cancelling a link stops it working. Linked forms go out with booking confirmations and Covered Beauty reminds clients 48 hours before if incomplete. Review a ready-made form before asking the agent to enable it.
Client records return signed-form names and dates, never form answers. Notes are saved as supplied; add a correcting note if needed. These hosted capabilities do not handle your Stripe account, payouts, refunds, plan, billing or kiosk PIN. Your Covered Beauty plan and signed-in role determine what is visible.
## Optional local stdio bridge
Python 3.10 or newer, with no runtime dependencies. Clone this repository and configure a client supporting stdio:
```json
{"mcpServers":{"covered-beauty":{"command":"python3","args":["/absolute/path/to/covered-beauty-mcp/covered_beauty_agent.py"],"env":{"COTLET_API_KEY":"your-cotlet-key"}}}}
```
The bridge exposes seven browser helpers: `covered_beauty_guide`, `covered_beauty_status`, `covered_beauty_open`, `covered_beauty_read`, `covered_beauty_click`, `covered_beauty_type` and `covered_beauty_close`. These forward to shared Cotlet.dev browser tools, separate from the eight 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 salon account.
```bash
python3 covered_beauty_agent.py connect
python3 covered_beauty_agent.py guide
python3 covered_beauty_agent.py status
python3 covered_beauty_agent.py serve
```
You can build the included Dockerfile and pass `COTLET_API_KEY` through the environment.
## Reference and access
- [Covered Beauty connection guide and complete operation reference](https://cotlet.dev/integrations/covered-beauty-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=covered-beauty)
- [Request access](https://cotlet.dev/signup?app=covered-beauty)
- [Cotlet.dev console](https://cotlet.dev/app)
Licensed under Elastic License 2.0. See LICENSE.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues