Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http fresha https://cotlet.dev/mcp/v1/fresha/connect
Open on GitHub

What 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/connect

2Platform CLI

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>

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.

Similar MCP servers

All MCP servers for Automation and no-code: n8n, Zapier, Make →

Project sponsors

Companies that keep this analytics open