Fresha by Cotlet — Claude Code MCP server: what it does
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.
no license ★ 7 updated 2026-10-24
claude mcp add --transport http fresha https://cotlet.dev/mcp/v1/fresha/connectWhat Fresha by Cotlet 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.
What it helps with
- 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 for the agent
- Show all appointments for October 27, 2026
- Book a client for a haircut tomorrow at 3 PM
- Pull the sales summary for last week
How to install Fresha by Cotlet
1Platform CLI: remote server
claude mcp add --transport http fresha https://cotlet.dev/mcp/v1/fresha/connect2Platform CLI
claude mcp add fresha-by-cotlet -- uvx fresha-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from fresha-api-mcp <command>
1Platform CLI: remote server
codex mcp add fresha-by-cotlet --url https://cotlet.dev/mcp/v1/fresha/connect2Platform CLI
codex mcp add fresha-by-cotlet -- uvx fresha-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from fresha-api-mcp <command>
Config file
{
"mcpServers": {
"fresha-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/fresha/connect"
}
}
}{
"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>
Config file
{
"servers": {
"fresha-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/fresha/connect"
}
}
}{
"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>
1Platform CLI: remote server
gemini mcp add -t http fresha-by-cotlet https://cotlet.dev/mcp/v1/fresha/connect2Platform CLI
gemini mcp add fresha-by-cotlet uvx fresha-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from fresha-api-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Fresha by Cotlet
How to install Fresha by Cotlet in Claude Code?
Hosted version: claude mcp add --transport http fresha https://cotlet.dev/mcp/v1/fresha/connect. Self-hosted: claude mcp add fresha-by-cotlet -- uvx fresha-api-mcp, then fresha-mcp connect to attach to Chrome.
What does Fresha by Cotlet do?
Connects an AI agent to salon data on Fresha: appointments, clients, services, team, sales, reviews. Can book, reschedule and cancel appointments, block time, read and write client notes.
Why does Fresha by Cotlet need Chrome?
The server pulls session cookies from the browser where you are signed in at partners.fresha.com. Fresha has no public API; the only way to connect is to reuse your session via the DevTools Protocol.