SalonBridge MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SalonBridge MCP Server Book a client for a haircut with Jess next Tuesday at 2pm and ask me to confirm."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SalonBridge MCP server for ChatGPT and Claude
Yes, ChatGPT, Claude and other AI agents can work in your SalonBridge account. Cotlet.dev connects your signed-in Cloud Browser to a hosted SalonBridge MCP server for appointments, clients, payments, stock and reports. Write actions ask for your confirmation by default.
What you can ask
Book a client into the calendar for a service and staff member, after I confirm.
Find the messages sent to a client last week.
Show the form responses linked to a client.
Review last month's income, expenses and net profit.
Show the staff working roster for next week.
Related MCP server: Mangomint MCP Server
Connect your agent
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
ChatGPT
Settings → Apps → add connector URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev. No API key needed.
Claude
Add https://cotlet.dev/mcp/v1/connect under Settings > Connectors and sign in to Cotlet.dev.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its SalonBridge tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
Or with Docker:
docker build -t salonbridge-mcp .
docker run -i --rm -e COTLET_API_KEY salonbridge-mcpTools: salonbridge_guide, salonbridge_status, salonbridge_open, salonbridge_read, salonbridge_click, salonbridge_type, salonbridge_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, nothing else to install. Run straight from this repo:
export COTLET_API_KEY="your-key"
python3 salonbridge_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 salonbridge_agent.py status # is SalonBridge ready in your Cotlet.dev account
python3 salonbridge_agent.py guide # SalonBridge screens and sign-in link
python3 salonbridge_agent.py read # open SalonBridge, read the page, close the browser
python3 salonbridge_agent.py tools # list Cotlet.dev tools
python3 salonbridge_agent.py serve # start the stdio MCP server (same as no argument)Questions from SalonBridge users
Does SalonBridge have an API?
The Cotlet.dev integration page links to SalonBridge API documentation at developers.mysalonbridge.com, checked 16 November 2026. Cotlet.dev works in your signed-in SalonBridge console.
How do I connect SalonBridge to ChatGPT?
Sign up at https://cotlet.dev/signup?app=salonbridge, enable SalonBridge and sign in at online.mysalonbridge.com in your Cotlet.dev Cloud Browser. Add https://cotlet.dev/mcp/v1/connect to ChatGPT with OAuth.
Can I use SalonBridge with Claude?
Yes. Add https://cotlet.dev/mcp/v1/connect as a custom connector in Claude and sign in to Cotlet.dev.
Is this an official SalonBridge MCP server?
No. Cotlet.dev is independent and not affiliated with SalonBridge. Your SalonBridge package and staff permissions determine which work you can do.
Source and setup
Start free: https://cotlet.dev/signup?app=salonbridge&utm_source=github&utm_medium=readme&utm_campaign=salonbridge
Available Tools
7 toolssalonbridge_clickB
Click a numbered element on the current SalonBridge page.
Inputs: element (required).
salonbridge_closeA
Close the SalonBridge browser session when the work is done, so credits stop running.
Inputs: no named parameters.
salonbridge_guideA
How to work in SalonBridge (salon appointments, clients, payments, stock and reports): its screens and the sign-in link. Call this first.
Inputs: task.
salonbridge_openA
Open a SalonBridge page in your signed-in Cloud Browser (default https://online.mysalonbridge.com) to work with salon appointments, clients, payments, stock and reports.
Inputs: url.
salonbridge_readB
Read the current SalonBridge page: its text and numbered buttons, links and fields.
Inputs: element.
salonbridge_statusA
Check that your Cotlet.dev account and SalonBridge are ready: account, credits and SalonBridge connection.
Inputs: no named parameters.
salonbridge_typeB
Type text into a numbered field on the current SalonBridge page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
The core browser primitives (open, read, click, type, close) target clearly distinct actions and resources, so an agent is unlikely to misselect among them. The only mild overlap is between salonbridge_guide and salonbridge_status, which both serve onboarding/setup and could be confused at the start of a session, though the descriptions differentiate documentation from account readiness checks.
All tools share a stable 'salonbridge_' prefix, giving a predictable namespace. The suffixes are mostly verbs (open, read, click, type, close) with two noun-style names (guide, status), a minor deviation that remains readable and unsurprising.
Seven tools is well-scoped for a browser-driven app automation server: one guide, one readiness check, and five session primitives that each earn their place. There is no padding or redundancy.
The surface covers the basic lifecycle (onboard, open, read, click, type, close), but lacks common interaction operations a salon-app workflow would need, such as direct navigation/URL entry, dropdown or date-picker selection, and key submission (Enter/Tab). Agents can work around some of this by clicking numbered elements, but form filling with selects and date fields will likely stall.
Related MCP Connectors
Salonized MCP server for ChatGPT, Claude and any AI agent: list appointments, book appointment, find customer, add customer note and get sales report in your own Salonized account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Salonized yourself; Cotlet does not store your password and you need no Salonized API key. About the official Salonized API: Salonized has no public API, webhooks or MCP server (checked 31 Oct 2026). Its help center has no article on any of them, and the only public endpoints, a 2018 wiki page, serve the online booking widget. Setup and FAQ: https://cotlet.dev/integrations/salonized-api-mcp-server
Salonist MCP server for ChatGPT, Claude and any AI agent: book appointment, reschedule appointment, list clients, create bill and assign package in your own Salonist account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Salonist yourself; Cotlet does not store your password and you need no Salonist API key. About the official Salonist API: Salonist lists API access and custom integrations only on its top Expert plan, and its public API covers mainly booking widget calls (checked 8 Nov 2026). It has no official MCP server. Setup and FAQ: https://cotlet.dev/integrations/salonist-api-mcp-server
Phorest MCP server for ChatGPT, Claude and any AI agent: book appointment, reschedule appointment, list clients, find free slots and add client note in your own Phorest account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Phorest yourself; Cotlet does not store your password and you need no Phorest API key. About the official Phorest API: Phorest has an API, but credentials come only through Phorest Support with your account number, and Phorest says integration needs your own development team (checked 8 Nov 2026). It has no webhooks and no official MCP server. Setup and FAQ: https://cotlet.dev/integrations/phorest-api-mcp-server
Fresha MCP server for ChatGPT, Claude and any AI agent: list appointments, create appointment, reschedule appointment, list clients and get sales summary in your own Fresha account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Fresha yourself; Cotlet does not store your password and you need no Fresha API key. About the official Fresha API: Fresha has no public API and no developer docs (checked 11 Oct 2026). Its only official data connection is the paid Data Connector add-on, which syncs your data out to reporting tools through a Snowflake database connection. Setup and FAQ: https://cotlet.dev/integrations/fresha-api-mcp-server
Related MCP Servers
- AlicenseCqualityCmaintenanceEnables AI assistants to read a salon's Booksy Biz calendar, staff schedules, clients, payments and reports through the user's own logged-in browser tab, without extracting session tokens or spoofing browser fingerprints.89MIT
- AlicenseAqualityBmaintenanceConnects a signed-in Mangomint account to Claude Code, ChatGPT, Cursor and other AI agents so they can book and move appointments, check daily schedules and stylist gaps, reply to client messages, and pull client lists using plain language. No Mangomint API key or public API is required, since the server works directly inside the user's own Mangomint account.732 PyPIElastic 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to work in a user's signed-in GlossGenius account, allowing natural-language booking, rescheduling, schedule queries, and client follow-ups without requiring a GlossGenius API key.7Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceEnables ChatGPT, Claude, and AI agents to read Salonized appointments, customers, waiting list, notes, and sales reports, while requiring approval before writes or customer notifications.Elastic 2.0