# Fresha by Cotlet

Fresha by Cotlet — an MCP server that gives AI agents access to salon appointments, clients, sales and reviews on Fresha. Runs against your Chrome session.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: cotletdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cotletdev/fresha-api-mcp-server
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/fresha-by-cotlet

## What it does

The server exposes 17 tools: booking, rescheduling and cancelling appointments, free slots, blocked time, client records and notes, services and team, sales reports, reviews with replies. Fresha has no public API; its paid Data Connector copies data to Snowflake and cannot book.

After install, `fresha-mcp connect` reads cookies from Chrome via the DevTools Protocol and saves them to `~/.config/fresha-api-mcp/session.json`. Each tool call hits Fresha's internal APIs (`partners-api`, the `partners-api-gateway` GraphQL, `customers-api`, `reports.fresha.com`) with those cookies. The session lives 25 days; Fresha renews it as you use the panel or the tools.

Requires Python 3.11 or later, Chrome 144+ signed in at `partners.fresha.com`. Licensed under PolyForm Noncommercial for personal use only; the author offers a hosted version at `cotlet.dev` for commercial customers.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://cotlet.dev/mcp/v1/fresha/connect`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http fresha https://cotlet.dev/mcp/v1/fresha/connect
```

2. **Platform CLI**
```bash
claude mcp add fresha-by-cotlet -- uvx fresha-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fresha-api-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add fresha-by-cotlet --url https://cotlet.dev/mcp/v1/fresha/connect
```

2. **Platform CLI**
```bash
codex mcp add fresha-by-cotlet -- uvx fresha-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fresha-api-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fresha-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/fresha/connect"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fresha-by-cotlet": {
            "command": "uvx",
            "args": [
                "fresha-api-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from fresha-api-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fresha-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/fresha/connect"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fresha-by-cotlet": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "fresha-api-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from fresha-api-mcp <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http fresha-by-cotlet https://cotlet.dev/mcp/v1/fresha/connect
```

2. **Platform CLI**
```bash
gemini mcp add fresha-by-cotlet uvx fresha-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fresha-api-mcp <command>

## When to use it
- fetch a salon's appointment list for a day
- book or cancel a client appointment
- pull a sales report from Fresha
- get a client record with notes
- find available slots for a service

## Example prompts
- Show all appointments for October 27, 2026
- Book a client for a haircut tomorrow at 3 PM
- Pull the sales summary for last week

## Similar
- [ChairFlow](https://affpapa.org/en/nevibecode/mcp/chairflow.md) — MCP server · 235 installs
- [Easy!Appointments](https://affpapa.org/en/nevibecode/mcp/easyappointments.md) — MCP server
- [Contractor Foreman by Cotlet](https://affpapa.org/en/nevibecode/mcp/contractor-foreman-by-cotlet.md) — MCP server · ★ 8 repo stars
- [Pirate Ship by Cotlet](https://affpapa.org/en/nevibecode/mcp/pirate-ship-by-cotlet.md) — MCP server · ★ 6 repo stars
- [DaySchedule](https://affpapa.org/en/nevibecode/mcp/dayschedule.md) — MCP server
- [website-builder](https://affpapa.org/en/nevibecode/skills/website-builder.md) — skill · 129000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
