Fresha salon and spa booking MCP server: list appointments, create appointment.
MCP Server: dev.cotlet/fresha
The MCP server dev.cotlet/fresha provides access to appointment, client, sales, and review data for salons and spas. Its purpose is to expose these operational domains through MCP so developer tooling can integrate with the underlying service that manages bookings and related business records.
🛠️ Key Features
Appointments
Clients
Sales
Reviews
Salon and spa focus
🚀 Use Cases
Retrieve or process salon/spa appointment information
Manage client-related workflows for salons and spas
Support sales and transaction reporting for salon/spa operations
Incorporate review data into salon/spa tooling and dashboards
The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call and its credit balance. Free. Needs the user's Cotlet API key or sign-in.
The apps of the user's workspace and whether each works now: access granted or requested, the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.
Parameters1
app
string
optional
Only this app, e.g. skool.
Raw schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only this app, e.g. skool."
}
},
"additionalProperties": false
}
cotlet_request_apps
Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser; any other works now in the user's Web browser with cotlet_app_guide, and the Cotlet team builds its dedicated tools on demand. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.
Parameters2
apps
array
required
App slugs, e.g. ["skool", "substack"].
use_case
string
optional
What the user wants the agent to do in these apps, in their words.
Raw schema
{
"type": "object",
"properties": {
"apps": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 10,
"description": "App slugs, e.g. [\"skool\", \"substack\"]."
},
"use_case": {
"type": "string",
"maxLength": 1000,
"description": "What the user wants the agent to do in these apps, in their words."
}
},
"required": [
"apps"
],
"additionalProperties": false
}
cotlet_get_call
Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.
Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL works once. Free. Needs the user's Cotlet API key or sign-in.
Sends a report straight to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a tool, field or app the task needed and Cotlet lacks. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.
Parameters7
kind
string
required
bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user wants. missing_feature: an app is here but lacks a tool, field or option the task needed. other: anything else.
title
string
required
One line, e.g. 'skool_list_members stops after 50 members'.
description
string
required
What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.
app
any
optional
App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'.
tool
any
optional
Tool or endpoint name, e.g. 'skool_list_members'.
call_id
any
optional
call_id of the call that went wrong, if any.
client
any
optional
Agent or tool sending this, e.g. 'Claude Code'.
Raw schema
{
"type": "object",
"properties": {
"kind": {
"description": "bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user wants. missing_feature: an app is here but lacks a tool, field or option the task needed. other: anything else.",
"enum": [
"bug",
"error",
"feature_request",
"missing_feature",
"other"
],
"title": "Kind",
"type": "string"
},
"title": {
"description": "One line, e.g. 'skool_list_members stops after 50 members'.",
"maxLength": 200,
"minLength": 3,
"title": "Title",
"type": "string"
},
"description": {
"description": "What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.",
"maxLength": 5000,
"minLength": 10,
"title": "Description",
"type": "string"
},
"app": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'.",
"title": "App"
},
"tool": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Tool or endpoint name, e.g. 'skool_list_members'.",
"title": "Tool"
},
"call_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "call_id of the call that went wrong, if any.",
"title": "Call Id"
},
"client": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Agent or tool sending this, e.g. 'Claude Code'.",
"title": "Client"
}
},
"required": [
"kind",
"title",
"description"
],
"additionalProperties": false,
"description": "Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.",
"title": "AgentReportCreate"
}
cotlet_browser_open
Wakes the user's Fresha Cloud Browser, a real Chrome hosted on Cotlet and signed in to Fresha as the user. Use it for what the Fresha tools do not cover. Opens `url` when given and returns the page's URL, title and tab. In the web browser `url` opens in the open tab of the same site, else in a new tab when the shown tab already has a site open (at the tab limit in the tab you opened and used longest ago), so the user's other apps stay as they are (the tabs tool lists them). The user watches every step live. Before the first step in an app, Cotlet's app guide says which browser to use and how to work in the app. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
url
string
optional
A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.
Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com. In an app's browser, a page of that app."
}
},
"additionalProperties": false
}
cotlet_browser_navigate
Opens a public http or https address in the user's Fresha Cloud Browser and returns the URL and title it ended on. Only Fresha pages open. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
url
string
required
A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.
Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com. In an app's browser, a page of that app."
}
},
"required": [
"url"
],
"additionalProperties": false
}
cotlet_browser_read
Returns the current page of the user's Fresha Cloud Browser: its readable text, up to 20,000 characters, and a numbered list of its links, buttons, fields, options and toggles, also inside frames. Open dialogs and cookie banners come first: they cover the page, so close or answer them first. Field values, cookies and storage are never returned. On a page longer than that, both start near where it is scrolled to; `element` reads only the part inside that element (a dialog, a form, a list). Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
element
integer
optional
Read only inside this element of the last read.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "Read only inside this element of the last read."
}
},
"additionalProperties": false
}
cotlet_browser_screenshot
Returns a JPEG image of the visible part of the current page in the user's Fresha Cloud Browser, with its URL and title: boards, canvases and layouts that the page text does not show. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Scrolls the current page in the user's Fresha Cloud Browser with the mouse wheel, as a person does: down or up by `screens` viewport heights (default 0.8), to the top or the bottom, or until element `element` is in view. Content that loads on scroll appears, and the next read lists it. Returns the URL, title and scroll position (at_top, at_bottom). Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
direction
string
optional
Where to scroll. Default: down.
screens
number
optional
How far, in viewport heights, for down and up. Default: 0.8.
element
integer
optional
Scroll until this element of the element list is in view.
inside
integer
optional
Scroll inside this element (a list in a dialog or a side panel), not the page.
Raw schema
{
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"down",
"up",
"top",
"bottom"
],
"description": "Where to scroll. Default: down."
},
"screens": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10,
"description": "How far, in viewport heights, for down and up. Default: 0.8."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Scroll until this element of the element list is in view."
},
"inside": {
"type": "integer",
"minimum": 1,
"description": "Scroll inside this element (a list in a dialog or a side panel), not the page."
}
},
"additionalProperties": false
}
cotlet_browser_click
Clicks a link, button, option or other element of the current page in the user's Fresha Cloud Browser, by its number in the page's element list, or a point of the screenshot (`x`, `y`) for boards, canvases and maps. Returns the URL and title after the click, and says when nothing on the page changed. It acts as the user on that site. Buttons that pay or buy and buttons on account or sign-in pages are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters6
element
integer
optional
The element's number in the element list of the current page.
x
number
optional
Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps).
y
number
optional
With `x`: pixels from the top of the screenshot.
double
boolean
optional
Double-click.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"double": {
"type": "boolean",
"description": "Double-click."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
}
cotlet_browser_type
Types text into a field of the current page in the user's Fresha Cloud Browser, by the field's number in the page's element list, and with `submit` presses Enter. Returns the URL and title after it. Password, card and one-time code fields and sign-in pages are refused: the user fills those in themselves. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters6
element
integer
required
The element's number in the element list of the current page.
text
string
required
The text to type.
submit
boolean
optional
Press Enter after typing, e.g. to search.
slowly
boolean
optional
Type key by key: for a search or address field whose suggestions do not appear. Read after it; the suggestions are listed as options to click.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"text": {
"type": "string",
"maxLength": 5000,
"description": "The text to type."
},
"submit": {
"type": "boolean",
"description": "Press Enter after typing, e.g. to search."
},
"slowly": {
"type": "boolean",
"description": "Type key by key: for a search or address field whose suggestions do not appear. Read after it; the suggestions are listed as options to click."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"required": [
"element",
"text"
],
"additionalProperties": false
}
cotlet_browser_select
Chooses an option of a drop-down list on the current page in the user's Fresha Cloud Browser, by the list's number in the element list and the option's label as read lists it (or its value). Returns the URL and title after it. Card fields and account pages are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
element
integer
required
The element's number in the element list of the current page.
option
string
required
The option.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"option": {
"type": "string",
"maxLength": 300,
"description": "The option."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"required": [
"element",
"option"
],
"additionalProperties": false
}
cotlet_browser_press
Presses a key on the current page in the user's Fresha Cloud Browser, on the element that has focus: Tab to the next field, Enter to send, Escape to close a dialog or pop-up, arrows to move through a suggestion list or a slider, or one character (a site's shortcut). Returns the URL and title after it, and says when nothing changed. Enter on account pages and characters into password fields are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
key
string
required
One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or a single character such as a or 5.
repeat
integer
optional
Press it this many times, e.g. ArrowDown 3 times. Default 1.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"key": {
"type": "string",
"anyOf": [
{
"enum": [
"Enter",
"Tab",
"Shift+Tab",
"Escape",
"Backspace",
"Delete",
"Space",
"ArrowDown",
"ArrowUp",
"ArrowLeft",
"ArrowRight",
"PageDown",
"PageUp",
"Home",
"End"
]
},
{
"pattern": "^[ -~]$"
}
],
"description": "One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or a single character such as a or 5."
},
"repeat": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Press it this many times, e.g. ArrowDown 3 times. Default 1."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"required": [
"key"
],
"additionalProperties": false
}
cotlet_browser_upload
Puts files into a file field of the current page in the user's Fresha Cloud Browser, or into the file picker that an upload button opens, by its number in the element list. A file is given as {"url": "https://..."} for a file online or {"file_id": "..."} for one uploaded to Cotlet first; up to 10 files, 20 MB each. Returns the URL and title after it. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters2
element
integer
required
The element's number in the element list of the current page.
files
array
required
The files.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"files": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public file URL."
},
"file_id": {
"type": "string",
"description": "A file uploaded to Cotlet."
}
},
"additionalProperties": false
},
"description": "The files."
}
},
"required": [
"element",
"files"
],
"additionalProperties": false
}
cotlet_browser_back
Goes back one page in the user's Fresha Cloud Browser, like the browser's Back button (with `forward`, forward again). Returns the URL and title. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters3
forward
boolean
optional
Go forward instead of back.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"forward": {
"type": "boolean",
"description": "Go forward instead of back."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
}
cotlet_browser_hover
Rests the pointer on an element of the current page (or a point of the screenshot) in the user's Fresha Cloud Browser, as a person does to open a hover menu, a tooltip or a card's preview. Read after it for what opened. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters3
element
integer
optional
The element's number in the element list of the current page.
x
number
optional
Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps).
y
number
optional
With `x`: pixels from the top of the screenshot.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false
}
cotlet_browser_drag
Drags from one element or point of the screenshot to another in the user's Fresha Cloud Browser: a piece on a board, a card between columns, a field into a form builder, a slider's handle. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
from
object
required
An element number, or x and y of the screenshot.
to
object
required
An element number, or x and y of the screenshot.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false,
"description": "An element number, or x and y of the screenshot."
},
"to": {
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false,
"description": "An element number, or x and y of the screenshot."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
cotlet_browser_wait
Waits until `text` shows on the current page in the user's Fresha Cloud Browser (at most `seconds`, default 5, up to 20), or just `seconds` without text: for results, prices or a page that load slowly. Says whether the text appeared. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Ends the session in the user's Fresha Cloud Browser: the browser keeps its cookies, goes to sleep and the per-minute charge stops. Returns the session's minutes and credits.
How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's dedicated tools when Cotlet has them. Call it before the first browser step in an app. Works for any web app; one outside Cotlet's catalog gets the general method. Free, no browser session.
Parameters2
app
string
optional
The app's name or Cotlet slug. Default: Fresha.
task
string
optional
What the user wants done in the app, in their words.
Raw schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"maxLength": 120,
"description": "The app's name or Cotlet slug. Default: Fresha."
},
"task": {
"type": "string",
"maxLength": 500,
"description": "What the user wants done in the app, in their words."
}
},
"additionalProperties": false
}
find_available_slots
Free start times for one or more services with a team member, day by day. Asks the calendar for free start times as New appointment does, for the services done one after another, with one team member at one location, over up to 14 days. Give service_ids (service_id from list_services), or pricing_level_ids to pick a pricing level other than a service's first. In a business with several locations, pass location_id and a team member who works there (location_ids in list_team_members); without it the team member's primary location is used. Times are wall clock in the business's time zone; closed days have no times. Book a time with create_appointment, with the same team member and location.
Parameters6
date
string
required
First day to search.
days
integer
optional
Days to search. Default: 1.
location_id
string
optional
Location to book at, from list_team_members. Default: the team member's primary location, else the business's first location.
service_ids
array
optional
service_id values from list_services (not pricing_level_id), done one after another in this order. Use the same location_id as in list_services.
team_member_id
string
optional
Team member to book. Default: the first at the location who takes bookings.
pricing_level_ids
array
optional
Instead of service_ids: pricing_level_id values from list_services, to book a pricing level other than a service's first one. Done one after another in this order.
Raw schema
{
"type": "object",
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "First day to search."
},
"days": {
"type": "integer",
"maximum": 14,
"minimum": 1,
"description": "Days to search. Default: 1."
},
"location_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Location to book at, from list_team_members. Default: the team member's primary location, else the business's first location."
},
"service_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9]+$"
},
"maxItems": 5,
"minItems": 1,
"description": "service_id values from list_services (not pricing_level_id), done one after another in this order. Use the same location_id as in list_services."
},
"team_member_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Team member to book. Default: the first at the location who takes bookings."
},
"pricing_level_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9]+$"
},
"maxItems": 5,
"minItems": 1,
"description": "Instead of service_ids: pricing_level_id values from list_services, to book a pricing level other than a service's first one. Done one after another in this order."
}
},
"required": [
"date"
],
"additionalProperties": false
}
get_appointment
One appointment: client, services, team member, times, status, price and notes. Reads the appointment as its drawer in the calendar shows it: status, start and end (wall clock in the business's time zone), the client, each booked service with its team member and length, the total and what is left to pay, and the appointment notes.
One client: contact, notification settings, booking stats, upcoming appointments, notes. Reads the client profile as the client's page shows it: name, email, mobile, gender, birthday, whether Fresha sends them appointment messages and marketing by email, SMS and WhatsApp, booking and sales totals, the next 10 appointments and the latest 10 notes.
Sales summary for a period: sales, refunds, discounts, taxes and payments by type. Reads Reports > Sales summary for the days given: one row per sale type (services, products, memberships, gift cards and so on) with Fresha's own columns (gross and net sales, discounts, refunds, taxes) and a totals row. columns names each key. A period without sales has no rows. Amounts are in the business's currency.
Appointments in a date range, with client, service, team member, price and status. Lists appointments that start between from and to (both days included; from defaults to today, to to from) as Sales > Appointments shows them, latest first: one row per booked service with its appointment id, reference, start (wall clock in the business's time zone), length, client, team member, price, status and channel (online or offline). Cancelled appointments are included with their status. location_id keeps one location of a business with several. Page with next_cursor. The report itself has no status, team member or client filter, so those three apply to the first 100 rows of the date range: for a busy range, narrow the dates.
Parameters8
to
string
optional
Last day of the range, included. Default: same as from.
from
string
optional
First day of the range (the day appointments start, YYYY-MM-DD). Default: today in the business's time zone.
limit
integer
optional
Page size. Default: 50.
cursor
string
optional
next_cursor from the previous call.
status
string
optional
Only this status, as Fresha names it: booked, confirmed, arrived, started, completed, canceled, no-show. Default: all.
client_id
string
optional
Only this client's appointments.
location_id
string
optional
Only appointments at this location. Default: all.
team_member_id
string
optional
Only this team member's appointments.
Raw schema
{
"type": "object",
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Last day of the range, included. Default: same as from."
},
"from": {
"type": "string",
"format": "date",
"description": "First day of the range (the day appointments start, YYYY-MM-DD). Default: today in the business's time zone."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size. Default: 50."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous call."
},
"status": {
"type": "string",
"description": "Only this status, as Fresha names it: booked, confirmed, arrived, started, completed, canceled, no-show. Default: all."
},
"client_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Only this client's appointments."
},
"location_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Only appointments at this location. Default: all."
},
"team_member_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Only this team member's appointments."
}
},
"additionalProperties": false
}
list_clients
Clients of the business, searchable by name, email or phone. Lists clients as the Client list shows them, newest first by default, with email, mobile, gender, total sales, review count and whether they are blocked. search matches name, email or phone. total is the number of matching clients. Page with next_cursor.
Parameters4
sort
string
optional
Order: newest (default), oldest or name.
limit
integer
optional
Page size, at most 50 (Fresha refuses more). Default: 50.
Client reviews of the business with rating, text and replies. Lists reviews as Online reputation shows them, newest first: star rating, text, author, the client and appointment it is about, source (Fresha or Google) and the replies. Filter by rating, source, words or reviews still without a reply. Page with next_cursor.
Parameters6
limit
integer
optional
Page size. Default: 50.
cursor
string
optional
next_cursor from the previous call.
search
string
optional
Words in the review.
source
string
optional
Only Fresha or Google reviews.
ratings
array
optional
Only these star ratings.
unreplied_only
boolean
optional
Only reviews without a reply. Default: false.
Raw schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size. Default: 50."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous call."
},
"search": {
"type": "string",
"description": "Words in the review."
},
"source": {
"enum": [
"fresha",
"google"
],
"type": "string",
"description": "Only Fresha or Google reviews."
},
"ratings": {
"type": "array",
"items": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"description": "Only these star ratings."
},
"unreplied_only": {
"type": "boolean",
"description": "Only reviews without a reply. Default: false."
}
},
"additionalProperties": false
}
list_sales
Sales (invoices) in a date range: number, date, client, status and totals. Lists sales as Sales > Sales list shows them for the days given, one row per sale with Fresha's columns (sale number, date, client, status, gross total and so on; linked records come with an `_id`). Amounts are in the business's currency. Page with next_cursor.
Services of the business with category, duration and price. Lists the active services of one location as the Catalogue shows them, with their category, duration in minutes, price and whether clients can book them online. A business with several locations: pass location_id (from list_team_members) and use the same location_id when you book. A service with several prices (by length or level) lists each as a pricing level; service_ids book the first one, pricing_level_ids a chosen one. Use service_id in find_available_slots and create_appointment.
Parameters2
search
string
optional
Only services whose name contains this.
location_id
string
optional
Location whose services to list, from list_team_members. Default: the business's first location.
Raw schema
{
"type": "object",
"properties": {
"search": {
"type": "string",
"description": "Only services whose name contains this."
},
"location_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Location whose services to list, from list_team_members. Default: the business's first location."
}
},
"additionalProperties": false
}
list_team_members
Team members with role, contact, services they do and whether they take bookings. Lists the team as Team members shows it: name, email, mobile, role (owner, manager, basic), job title, whether they take bookings and online bookings, the services assigned to them, their primary location (location_id) and every location they work at (location_ids). Also lists the business's locations. Use team_member_id in the calendar tools, with location_id set to one of that member's location_ids when the business has several.
Parameters2
location_id
string
optional
Only team members who work at this location.
include_former
boolean
optional
Also team members who left. Default: false.
Raw schema
{
"type": "object",
"properties": {
"location_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Only team members who work at this location."
},
"include_former": {
"type": "boolean",
"description": "Also team members who left. Default: false."
}
},
"additionalProperties": false
}
add_blocked_time
Block a time slot in a team member's calendar so nobody books it. Adds blocked time as Add > Blocked time in the calendar does: one block on one day for one team member at one location (default: their primary location), with a title and a note for the team. It does not repeat. Clients cannot book it online unless allow_online_booking is true. Nobody is told.
Parameters7
title
string
optional
Reason shown on the calendar, e.g. Lunch.
end_at
string
required
End on the same day. ISO 8601 like start_at.
start_at
string
required
Start, ISO 8601: 2026-11-03T14:30 is wall clock in the business's time zone; with an offset (2026-11-03T14:30:00+01:00) it is converted.
description
string
optional
Note your team sees on the block.
location_id
string
optional
Location whose calendar gets the block, one where the team member works. Default: the team member's primary location.
team_member_id
string
required
Team member id from list_team_members.
allow_online_booking
boolean
optional
Clients may still book this time online. Default: false.
Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"description": "Reason shown on the calendar, e.g. Lunch."
},
"end_at": {
"type": "string",
"description": "End on the same day. ISO 8601 like start_at."
},
"start_at": {
"type": "string",
"description": "Start, ISO 8601: 2026-11-03T14:30 is wall clock in the business's time zone; with an offset (2026-11-03T14:30:00+01:00) it is converted."
},
"description": {
"type": "string",
"maxLength": 1000,
"description": "Note your team sees on the block."
},
"location_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Location whose calendar gets the block, one where the team member works. Default: the team member's primary location."
},
"team_member_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Team member id from list_team_members."
},
"allow_online_booking": {
"type": "boolean",
"description": "Clients may still book this time online. Default: false."
}
},
"required": [
"team_member_id",
"start_at",
"end_at"
],
"additionalProperties": false
}
add_client
Add a client to the business's client list. Adds a client as Add client in the Client list does: name, email, mobile and gender. With appointment_messages (default true) Fresha sends the client booking confirmations and reminders to the email and mobile given; marketing (default false) records consent to marketing messages. Nothing is sent when the client is added.
Parameters7
email
string
optional
Email.
phone
string
optional
Mobile number with country code, e.g. +44 7700 900123.
gender
string
optional
Gender.
last_name
string
optional
Last name.
marketing
boolean
optional
The client agreed to marketing messages. Default: false.
first_name
string
required
First name.
appointment_messages
boolean
optional
Let Fresha send this client booking confirmations and reminders by email, SMS and WhatsApp. Default: true.
Add a note to a client's profile, seen by the team only. Adds a note to the client's Notes tab for all locations, as the profile's Add note does. Only the team sees it; the client is not told. Line breaks become paragraphs.
Cancel an appointment without a charge, optionally telling the client. Cancels the appointment as Cancel in its drawer does, with one of the business's cancellation reasons. With notify_client (default true) Fresha sends the client a cancellation message, so this can reach the client; false cancels quietly. whole_series also cancels the later appointments of a repeating series. An appointment with a cancellation fee or a paid deposit is refused: cancel it in Fresha. It cannot be undone here. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
Parameters4
scope
string
optional
this_appointment (default) or whole_series, for repeating appointments: this and every later one.
reason
string
optional
Name of one of the business's cancellation reasons, e.g. Client not available. Default: none.
notify_client
boolean
optional
Send the client a cancellation message. Default: true.
appointment_id
string
required
Appointment id from list_appointments.
Raw schema
{
"type": "object",
"properties": {
"scope": {
"enum": [
"this_appointment",
"whole_series"
],
"type": "string",
"description": "this_appointment (default) or whole_series, for repeating appointments: this and every later one."
},
"reason": {
"type": "string",
"description": "Name of one of the business's cancellation reasons, e.g. Client not available. Default: none."
},
"notify_client": {
"type": "boolean",
"description": "Send the client a cancellation message. Default: true."
},
"appointment_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Appointment id from list_appointments."
}
},
"required": [
"appointment_id"
],
"additionalProperties": false
}
create_appointment
Book an appointment for a client: services, team member and start time. Books the services one after another from start_at with one team member at one location, as New appointment in the calendar does, at each service's catalogue price. Give service_ids (service_id from list_services), or pricing_level_ids to pick a pricing level other than a service's first. In a business with several locations, pass location_id and a team member who works there (location_ids in list_team_members); without it the team member's primary location is used. Fresha may send the client a booking confirmation by their notification settings (get_client), so this can reach the client. Find free times with find_available_slots first: Fresha books over other appointments and returns its warnings. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
Parameters6
start_at
string
required
Start, ISO 8601: 2026-11-03T14:30 is wall clock in the business's time zone; with an offset (2026-11-03T14:30:00+01:00) it is converted.
client_id
string
optional
Client from list_clients. Without it: a walk-in.
location_id
string
optional
Location to book at, from list_team_members. Default: the team member's primary location, else the business's first location.
service_ids
array
optional
service_id values from list_services (not pricing_level_id), done one after another in this order. Use the same location_id as in list_services.
team_member_id
string
optional
Team member. Default: the first at the location who takes bookings.
pricing_level_ids
array
optional
Instead of service_ids: pricing_level_id values from list_services, to book a pricing level other than a service's first one. Done one after another in this order.
Raw schema
{
"type": "object",
"properties": {
"start_at": {
"type": "string",
"description": "Start, ISO 8601: 2026-11-03T14:30 is wall clock in the business's time zone; with an offset (2026-11-03T14:30:00+01:00) it is converted."
},
"client_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Client from list_clients. Without it: a walk-in."
},
"location_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Location to book at, from list_team_members. Default: the team member's primary location, else the business's first location."
},
"service_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9]+$"
},
"maxItems": 5,
"minItems": 1,
"description": "service_id values from list_services (not pricing_level_id), done one after another in this order. Use the same location_id as in list_services."
},
"team_member_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Team member. Default: the first at the location who takes bookings."
},
"pricing_level_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9]+$"
},
"maxItems": 5,
"minItems": 1,
"description": "Instead of service_ids: pricing_level_id values from list_services, to book a pricing level other than a service's first one. Done one after another in this order."
}
},
"required": [
"start_at"
],
"additionalProperties": false
}
reply_to_review
Post a public reply to a client's review. Posts a reply under the review as Reply in Online reputation does, signed as the business or the team member. The reply is public on the business's Fresha page and the client is told, so this reaches people. It needs a review that exists: take review_id from list_reviews. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
Parameters3
text
string
required
Reply text.
reply_as
string
optional
Sign the reply as the business (default) or as the team member signed in.
review_id
string
required
Review id from list_reviews.
Raw schema
{
"type": "object",
"properties": {
"text": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Reply text."
},
"reply_as": {
"enum": [
"business",
"team_member"
],
"type": "string",
"description": "Sign the reply as the business (default) or as the team member signed in."
},
"review_id": {
"type": "string",
"pattern": "^[0-9A-Za-z-]+$",
"description": "Review id from list_reviews."
}
},
"required": [
"review_id",
"text"
],
"additionalProperties": false
}
reschedule_appointment
Move an appointment to a new start time, optionally to another team member. Moves every service of the appointment by the same amount so the first starts at start_at, as Reschedule in the appointment drawer does; lengths and prices stay. team_member_id moves all services to that team member, who must work at the appointment's location (location_ids in list_team_members); the location itself stays. With notify_client (default true) Fresha sends the client a reschedule message by their notification settings; false moves it quietly. Cancelled, completed and no-show appointments are refused. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
Parameters4
start_at
string
required
New start. ISO 8601: 2026-11-03T14:30 is wall clock in the business's time zone; with an offset (2026-11-03T14:30:00+01:00) it is converted.
notify_client
boolean
optional
Let Fresha send the client a reschedule message, by their notification settings. Default: true.
appointment_id
string
required
Appointment id from list_appointments.
team_member_id
string
optional
New team member for every service, one who works at the appointment's location (location_ids in list_team_members). Default: unchanged.
Raw schema
{
"type": "object",
"properties": {
"start_at": {
"type": "string",
"description": "New start. ISO 8601: 2026-11-03T14:30 is wall clock in the business's time zone; with an offset (2026-11-03T14:30:00+01:00) it is converted."
},
"notify_client": {
"type": "boolean",
"description": "Let Fresha send the client a reschedule message, by their notification settings. Default: true."
},
"appointment_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "Appointment id from list_appointments."
},
"team_member_id": {
"type": "string",
"pattern": "^[0-9]+$",
"description": "New team member for every service, one who works at the appointment's location (location_ids in list_team_members). Default: unchanged."
}
},
"required": [
"appointment_id",
"start_at"
],
"additionalProperties": false
}
Fresha API and MCP server: connect Fresha to ChatGPT and Claude
Yes, ChatGPT, Claude and other AI agents can work in your Fresha account. That includes Cursor, Codex, OpenClaw and any MCP client, plus automations in n8n, Make and Zapier. Ask in plain words, and the AI reads your calendar and open slots, books and moves appointments, answers reviews and reports your sales. It shows you what it will do first and sends nothing to other people until you say so.
As of November 2026, this repo is the missing piece: 17 Fresha tools for AI assistants and scripts.
What you can ask
Anna Smith emailed asking for a cut and colour with Sam on Friday afternoon. Find her, check the free times for both services and book the first one after my OK.
Sam is sick tomorrow. Block his day and show me which of his clients a colleague can take at the same time.
Yesterday's sales by sale type against the same day last week. Flag refunds over £50.
List the reviews without a reply and draft a short answer to each.
sign in to Fresha once, about 5 minutes, nothing to install
Python and a terminal
Works in
ChatGPT and Claude apps, on your phone too, Cursor, Codex, OpenClaw, any MCP client, n8n, Make, Zapier, REST API
Claude Code, Claude Desktop, Cursor, Codex on your computer
Runs
24/7, your computer can be off
while your computer is on
Price
7 days free, no card
free
Cotlet is best for salon, spa and wellness business owners who want ChatGPT, Claude or another AI agent to work in Fresha for them, with nothing to install.
A Fresha API and a Fresha MCP server you run on your own computer, in Python, on the session of your own Google Chrome. All 17 Fresha tools we run in production at Cotlet: appointments, free slots, booking, rescheduling and cancelling, blocked time, clients and client notes, services and team, the Sales summary and Sales list reports, and reviews with replies.
Fresha has no public API and no official MCP server. Its only data connection is the paid Data Connector add-on, which copies your data out to a Snowflake database and cannot book anything. This repo gives you:
MCP server for Claude Code, Claude Desktop, Cursor, Codex and any MCP client, over stdio or HTTP. Setup
REST API on http://127.0.0.1:8787/api/v1/fresha, with OpenAPI docs at /docs. Setup
Python: call("list_appointments", {"from": "2026-10-27", "to": "2026-10-27"}), plus 9 ready scripts in examples/.
Free for your own use, your own business included (license).
Does Fresha have an API?
No public one. Fresha publishes no API and no developer docs (checked 11 Oct 2026). Its Data Connector add-on, paid per location, syncs your data out to reporting tools through a Snowflake connection, and it cannot book, move or cancel appointments. This repo and Cotlet give you 17 Fresha tools as a REST API and an MCP server.
Can I get a Fresha API key?
Not from Fresha for your own account. With Cotlet you get your own API key that works with your Fresha account, for scripts, n8n, Make, Zapier or any HTTP client. This repo needs no key: it runs on your computer, on your own Fresha session.
Is there an official ChatGPT integration for Fresha?
Fresha's ChatGPT and Claude apps are for clients: they find salons and book open slots. They do not run your business. Cotlet connects your Fresha partner account to ChatGPT, Claude and other AI agents: your calendar, clients, team and sales.
How do I connect Fresha to ChatGPT?
Sign up at cotlet.dev, sign in to Fresha once in your Cloud Browser there, and add Cotlet to ChatGPT, following the steps in your account. Then ask ChatGPT about your Fresha like you would ask an assistant. ChatGPT needs a server on the internet, so this repo alone, running on your computer, does not connect to ChatGPT.
Can ChatGPT manage my Fresha calendar?
Yes, with Cotlet. It lists the day's appointments and gaps, finds open slots, books and moves appointments and blocks time. It shows you each change first.
Fresha has an AI receptionist. What does this add?
Fresha's AI answers your clients. With Cotlet, your own AI works for you in the back office: the calendar, clients, team and sales reports.
Can I automate Fresha with Zapier, Make or n8n?
Fresha has no Zapier or Make app. With Cotlet, n8n, Make and Zapier can read and book appointments and add clients, for example from a web form.
Can I use it from my phone?
Yes, with Cotlet: once it is set up, the ChatGPT and Claude apps on your phone can use Fresha for you.
Do I need to be technical?
For Cotlet, no: you sign in to Fresha and add Cotlet to ChatGPT or Claude, with step-by-step instructions in your account. This repo is for people who are fine with Python and a terminal.
Is my Fresha account safe?
Yes. Neither Cotlet nor this repo sees or stores your Fresha password. You sign in yourself, the way you always do, and the AI works on that signed-in session. Anything that reaches other people asks for your OK first: in Cotlet by default, here through your MCP client.
Is it free?
This repo is free, also in your own business. Cotlet is free for 7 days with no card, then one-time credit packs from $29, no subscription. Pricing.
I manage Fresha for several accounts or clients. Does that work?
Yes, with Cotlet. Each Fresha login gets its own connection. Write to contact@cotlet.dev and tell us how many accounts you manage.
How it works
text
AI agent (MCP) / script (REST, Python) ──▶ fresha-mcp on your computer ──your cookies──▶ *.fresha.com
▲
fresha-mcp connect ──────┘ reads them once from your Chrome (DevTools Protocol)
You sign in to Fresha for business in your own Chrome at partners.fresha.com, the way you always do: an email code, then a text message code. Tick Trust this device.
fresha-mcp connect attaches to that Chrome through the Chrome DevTools Protocol, reads the fresha.com cookies and saves them to ~/.config/fresha-api-mcp/session.json, readable by your user only. It never sees or stores your password or the codes.
Every tool call is a request to the APIs the Fresha partner panel itself calls (partners-api, the partners-api-gateway GraphQL, customers-api, reports.fresha.com and a few more *.fresha.com hosts) with those cookies, sent with curl_cffi, which copies Chrome's TLS fingerprint. No headless browser runs.
The session lives in one cookie, fresha_partners_session. Fresha keeps it for 25 days and renews it while you use the panel or the tools. When Fresha signs you out, the server reads the cookies from Chrome again, if Chrome is open with remote debugging on.
Requirements
Python 3.11 or newer.
Google Chrome 144 or newer, signed in to partners.fresha.com. Any Chrome or Chromium works with a debugging port.
macOS, Linux or Windows.
A Fresha for business account. We build and test with the workspace owner. A team member login sees what Fresha shows that team member, and the two sales tools need its reporting permissions.
With uv: uv venv && uv pip install -e ., then uv run fresha-mcp ....
Setting it up with an AI agent (Claude Code, Codex, Cursor)? Open it in this folder and ask it to set up the repo: AGENTS.md tells it every step, and it asks you only for the steps in Chrome.
To update: uv tool upgrade fresha-api-mcp (or pip install -U fresha-api-mcp), from source git pull && pip install -e .. We copy every change of the hosted Fresha tools into this repo.
Connect your Chrome
Option A: your everyday Chrome (recommended)
Open chrome://inspect/#remote-debugging in Chrome and switch remote debugging on. Chrome then accepts DevTools connections from programs on this computer, and asks you before each one.
Chrome asks whether to allow the connection. Click Allow.
text
Saved 24 Fresha cookies to /Users/you/.config/fresha-api-mcp/session.json
Signed in to Fresha as Daniel Hughes (daniel@example.com)
You can switch remote debugging off again afterwards. Leave it on if you want the server to pick up a new session by itself after Fresha signs you out.
connect looks for Chrome's DevToolsActivePort file in the default profile folder. For Chrome Beta, Canary or a custom profile folder, pass --profile-dir "<folder>".
Option B: a Chrome with a debugging port
Chrome does not open a debugging port on your default profile, so start a separate one, sign in to Fresha there once, and connect to it:
--cdp also takes a ws:// DevTools URL, for example of a Chrome on another machine reached over an SSH tunnel.
Option C: paste the cookie by hand
For a server with no Chrome: in Chrome open DevTools on partners.fresha.com, Application > Cookies > https://partners.fresha.com, copy the value of fresha_partners_session, then:
bash
fresha-mcp connect --token # paste it, input is hidden# or, without a session file:export FRESHA_AUTH_TOKEN=...
A pasted cookie is not read again from Chrome. Paste a new one when Fresha signs you out.
Check the session at any time:
bash
fresha-mcp status
MCP server
The MCP server lists every tool with its input schema, a description written for agents, and hints. Read tools are marked read-only, and the tools that can reach clients (booking, rescheduling, cancelling, review replies) are marked so your client asks before running them.
Claude Code
bash
claude mcp add fresha -- uvx fresha-api-mcp mcp
# read only:
claude mcp add fresha -- uvx fresha-api-mcp mcp --read-only
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
fresha-mcp serve also serves MCP over streamable HTTP at http://127.0.0.1:8787/mcp, for clients that take a URL:
bash
fresha-mcp serve
claude mcp add --transport http fresha http://127.0.0.1:8787/mcp
Then ask your agent things like:
Anna Smith emailed asking for a cut and colour with Sam on Friday afternoon. Find her, check the free times for both services and book the first one after my OK.
Sam is sick tomorrow. Block his day and show me which of his clients a colleague can take at the same time.
Yesterday's sales by sale type against the same day last week. Flag refunds over £50.
List the reviews without a reply and draft a short answer to each.
REST API
bash
fresha-mcp serve # http://127.0.0.1:8787, MCP at /mcp, docs at /docs
Each tool has its own route under /api/v1/fresha, the same paths as the hosted API at cotlet.dev, so code written against one works with the other. Path parts and the query string are arguments, and a JSON body adds the rest.
curl -X POST http://127.0.0.1:8787/api/v1/fresha/tools/list_clients -d '{"search": "smith"}'
GET /api/v1/fresha/tools: every tool with its route, input schema and an example answer.
GET /docs: interactive OpenAPI docs, GET /openapi.json the schema, for n8n, Postman or a generated client.
Answers are JSON. List tools return next_cursor; pass it back as cursor for the next page.
The server listens on 127.0.0.1 only. To reach it from another device of yours, set a token, and every request then needs Authorization: Bearer <token>:
Or one tool from the shell: fresha-mcp call find_available_slots service_ids='["25979401"]' date=2026-10-27 days=3, or with a JSON object. An ID stays text where the tool takes text.
Times are wall clock in the business's time zone. 2026-11-03T14:30 means 14:30 at the salon. A time with an offset is converted to it, and answers carry time_zone.
Ready scripts in examples/. Each prints JSON or a short list, takes --out file.csv or --out file.json where it makes sense, and --help:
On a schedule, cron on your own computer works while it is on: 0 8 * * * cd ~/fresha-api-mcp-server && .venv/bin/python examples/daily_sales.py.
All 17 tools
IDs come from the list tools: service_id from list_services, team_member_id from list_team_members, client_id from list_clients, appointment_id from list_appointments, review_id from list_reviews. fresha-mcp tools prints this list, fresha-mcp tools --json adds the input schemas.
Appointments
Tool
Access
REST route
What it does
list_appointments
read
GET /appointments
Appointments in a date range, with client, service, team member, price and status.
get_appointment
read
GET /appointments/{appointment_id}
One appointment: client, services, team member, times, status, price and notes.
find_available_slots
read
GET /available-slots
Free start times for one or more services with a team member, day by day.
create_appointment
write
POST /appointments
Book an appointment for a client: services, team member and start time.
reschedule_appointment
write
POST /appointments/{appointment_id}/reschedule
Move an appointment to a new start time, optionally to another team member.
cancel_appointment
write
POST /appointments/{appointment_id}/cancel
Cancel an appointment without a charge, optionally telling the client.
add_blocked_time
write
POST /blocked-times
Block a time slot in a team member's calendar so nobody books it.
Clients
Tool
Access
REST route
What it does
list_clients
read
GET /clients
Clients of the business, searchable by name, email or phone.
get_client
read
GET /clients/{client_id}
One client: contact, notification settings, booking stats, upcoming appointments, notes.
add_client
write
POST /clients
Add a client to the business's client list.
add_client_note
write
POST /clients/{client_id}/notes
Add a note to a client's profile, seen by the team only.
Catalogue and team
Tool
Access
REST route
What it does
list_services
read
GET /services
Services of the business with category, duration and price.
list_team_members
read
GET /team-members
Team members with role, contact, services they do and whether they take bookings.
Sales
Tool
Access
REST route
What it does
get_sales_summary
read
GET /sales-summary
Sales summary for a period: sales, refunds, discounts, taxes and payments by type.
list_sales
read
GET /sales
Sales (invoices) in a date range: number, date, client, status and totals.
Reviews
Tool
Access
REST route
What it does
list_reviews
read
GET /reviews
Client reviews of the business with rating, text and replies.
reply_to_review
write
POST /reviews/{review_id}/replies
Post a public reply to a client's review.
create_appointment lets Fresha send its booking confirmation by the client's notification settings; the tool has no switch for it. reschedule_appointment and cancel_appointment tell the client unless you pass notify_client: false. A review reply is public and the reviewer is told. Adding a client, a note or blocked time sends nothing. In list_appointments the status, team member and client filters apply to the first 100 rows of the date range, so narrow the dates for a busy salon.
Not in this version: payouts and the wallet (Fresha Payments), checkout and refunds, products, gift cards, memberships, the waitlist, marketing campaigns and shifts. create_appointment takes no appointment note, add_blocked_time blocks one day with no repeats, and cancel_appointment refuses an appointment with a cancellation fee or a paid deposit.
Never built, on purpose: your Fresha sign-in, email, password and user account, and anything that moves money (subscription, billing, payouts, payment methods). Every request passes a guard that refuses any change to those Fresha paths.
Configuration
Variable
Default
What it does
FRESHA_MCP_HOME
~/.config/fresha-api-mcp
Folder of session.json.
FRESHA_AUTH_TOKEN
The fresha_partners_session cookie value, used instead of session.json.
FRESHA_PROXY
Proxy for every request to Fresha, e.g. http://user:pass@host:port.
FRESHA_MCP_READ_ONLY
1 hides and refuses every tool that changes Fresha (same as --read-only).
FRESHA_MCP_TOKEN
Bearer token required by serve; needed to listen beyond 127.0.0.1.
FRESHA_MCP_HOST, FRESHA_MCP_PORT
127.0.0.1, 8787
Address of serve.
Security and your Fresha account
Your password never reaches this code. Only the cookies Chrome already holds are read, and only those of fresha.com.
The session file is yours.session.json is created with mode 0600. Anyone who has it can act as you in Fresha for business, so keep it out of git and shared folders.
Local by default.serve binds to 127.0.0.1 and refuses another address without FRESHA_MCP_TOKEN.
fresha.com only. Requests and redirects outside fresha.com are refused.
Read-only mode.--read-only or FRESHA_MCP_READ_ONLY=1 exposes the 10 read tools only.
Actions reach real people. A booking, a move or a cancellation can message your client, and a review reply is public. MCP clients ask before running those tools; a script does not, so try it on a test client of your own first.
Errors
The REST API answers {"error": "<code>", "message": "..."}. The MCP server returns the same code and message as a tool error.
Status
Code
What to do
401
auth_required, auth_expired
No session, or Fresha signed you out. Sign in at partners.fresha.com in Chrome and run fresha-mcp connect.
403
app_permission_denied
Your Fresha role cannot do this, e.g. reports without the reporting permissions.
403
scope_denied
The server runs read-only, or the request would change your Fresha account itself.
403
target_blocked
Fresha refused the request or showed a bot check. Open the panel in Chrome once, then retry.
409
captcha_required
Fresha asks for a CAPTCHA. Solve it in Chrome.
422
invalid_input
An argument is missing or wrong; the message names it.
429
rate_limited
Fresha is limiting the account. Wait a few minutes.
502
target_error
Fresha answered with an error (its own message is in message), or changed its panel. git pull for the latest tools, or open an issue.
your own Cloud Browser in the EU, profile encrypted with AES-256-GCM
When Fresha changes its panel
git pull once we have fixed it
fixed for you, every tool tested daily
Approvals
your MCP client asks per call
bookings, moves, cancellations and review replies wait for your OK, switchable per tool
Works with
MCP clients on your machine, local scripts
Claude.ai and ChatGPT connectors, n8n, Make, Zapier, any HTTP client
Who may use it
you and your own business
you, teams, businesses, agencies
Price
free
free 7-day trial with 2,000 credits, no card; then one-time packs from $29 for 5,000 credits
On the hosted version a successful call uses 10 credits, failed calls are free, and the Cloud Browser uses 50 credits a day while it has an app enabled for agents. Full pricing.
FAQ
Is there a Fresha MCP server for Claude, ChatGPT or Cursor?
Yes, this one runs on your machine: fresha-mcp mcp for Claude Code, Claude Desktop, Cursor and Codex. ChatGPT and Claude.ai connectors need a public HTTPS URL, which the hosted Fresha MCP server gives you. A community server on GitHub reads Data Connector tables from Snowflake; it needs the add-on and does not write anything.
Do I need the Data Connector add-on?
No. The tools work on your own partners.fresha.com session, the same requests the panel sends.
Can it find free slots and book for me?find_available_slots returns the free start times for one or more services done back to back, with one team member, for up to 14 days. create_appointment books one of them. Fresha books over other appointments if you ask it to, so check the slot first.
Can I export my Fresha clients or sales to CSV?
Yes: python examples/export_clients.py --out clients.csv and python examples/export_sales.py --from 2026-10-01 --to 2026-10-31 --out sales.csv.
Does it work outside the UK?
Yes. The tools read the time zone and currency of your workspace from Fresha. With several locations, the calendar tools use the first one.
Why does it need my Chrome?
To read your Fresha session without your password and the two sign-in codes. Chrome is used once per sign-in, not for each call.
What happens when Fresha signs me out?
Calls fail with auth_expired. With Chrome remote debugging on, the server reads the new session on the next call (click Allow when Chrome asks). Otherwise run fresha-mcp connect again.
Can it run on a VPS or in Docker?
Technically yes, with a pasted cookie or a session.json copied from your computer. Fresha then sees your session from a datacenter IP, which looks less like you. For an always-on setup the hosted version keeps your session in your own Cloud Browser on a fixed IP.
Will my Fresha account get banned?
Requests carry Chrome's fingerprint and go out one at a time, as you would click. Nobody can promise a platform never acts. Keep to your normal use.
Can I change the code or offer it to my clients?
You may change it and use it in your own business. You may not offer it to others as a hosted or managed service. For client work, use Cotlet or write to contact@cotlet.dev.
A tool broke or I need another one.Open an issue with the tool name and the error message.
Allowed: using it for yourself and in your own business, free. Changing the code and sharing it under the same license.
Not allowed: offering it to others as a hosted or managed service, removing the license notices, getting around its limits.
Maintained by Cotlet (@cotletdev). Fresha is a trademark of its owner. This project is unofficial and not affiliated with, endorsed or sponsored by Fresha.