Skip to main content
Glama

SalonBiz MCP server

Connect SalonBiz to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Read appointments, tickets, inventory, payments and reports in your own signed-in salon account. Booking changes, online booking settings and email campaigns ask for your approval by default.

What you can ask

List tomorrow's unconfirmed appointments.

List low-stock products before ordering.

Draft an email campaign for lapsed clients and show it before scheduling.

Related MCP server: Salonized MCP server

Connect in 2 minutes

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

Settings > Connectors > Add custom connector: https://cotlet.dev/mcp/v1/connect. Sign in with 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 SalonBiz 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.

Run the included Python module with Python 3.10 or later:

python3 salonbiz_agent.py serve

Or with Docker:

docker build -t salonbiz-mcp .
docker run -i --rm -e COTLET_API_KEY salonbiz-mcp

Tools: salonbiz_guide, salonbiz_status, salonbiz_open, salonbiz_read, salonbiz_click, salonbiz_type, salonbiz_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+, with no third-party runtime dependencies. Clone this repository and run:

export COTLET_API_KEY="your-key"
python3 salonbiz_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 salonbiz_agent.py status    # is SalonBiz ready in your Cotlet.dev account
python3 salonbiz_agent.py guide     # SalonBiz screens and sign-in link
python3 salonbiz_agent.py read      # open SalonBiz, read the page, close the browser
python3 salonbiz_agent.py tools     # list Cotlet.dev tools
python3 salonbiz_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from SalonBiz users

How do I connect my account?

Request access at https://cotlet.dev/signup?app=salonbiz, sign in to SalonBiz in your Cotlet.dev Cloud Browser and enable it for agents.

Can the agent take payments?

No. Tickets and payments are read only. Checkout, refunds and card charges stay with your team in SalonBiz.

Can I review changes?

Booking changes, online booking settings and campaigns ask for confirmation by default. You can change approval settings per tool.

Is Cotlet.dev affiliated with SalonBiz?

No. Cotlet.dev is independent and not affiliated with SalonBiz.

Learn more


More: https://cotlet.dev/integrations/salonbiz-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=salonbiz

Request access: https://cotlet.dev/signup?app=salonbiz&utm_source=github&utm_medium=readme&utm_campaign=salonbiz

Workflows on the hosted integration

Examples documented on the live integration page:

  • manage_appointment_book

  • manage_online_booking

  • view_point_of_sale

  • view_inventory

  • view_salon_payments

  • view_reporting

  • manage_marketing

The local stdio adapter exposes seven browser helpers listed above. These helpers forward to Cotlet.dev; the workflow operations are documented on the hosted integration page.

Available Tools

7 tools
salonbiz_clickB

Click a numbered element on the current SalonBiz page.

Inputs: element (required).

salonbiz_closeA

Close the SalonBiz browser session when the work is done, so credits stop running.

Inputs: no named parameters.

salonbiz_guideA

How to work in SalonBiz (read the appointment book, review stock and run salon reports): its screens and the sign-in link. Call this first.

Inputs: task.

salonbiz_openB

Open a SalonBiz page in your signed-in Cloud Browser (default https://central-app.salonbiz.com) to work with read the appointment book, review stock and run salon reports.

Inputs: url.

salonbiz_readA

Read the current SalonBiz page: its text and numbered buttons, links and fields.

Inputs: element.

salonbiz_statusA

Check that your Cotlet.dev account and SalonBiz are ready: account, credits and SalonBiz connection.

Inputs: no named parameters.

salonbiz_typeB

Type text into a numbered field on the current SalonBiz 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

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a distinct role in the browser-automation workflow: guide, readiness check, open, read, click, type, and close. There is little risk of confusing one action with another, and the descriptions reinforce the intended sequence.

    Naming Consistency5/5

    All tools use the same salonbiz_ prefix and lowercase snake_case action names. The pattern is predictable and easy to scan.

    Tool Count5/5

    Seven tools is well-scoped for a browser-assisted domain workflow. The set includes setup, interaction, reading, typing, and cleanup without unnecessary extras.

    Completeness4/5

    The core lifecycle is covered: check readiness, open a page, read it, click and type, then close the session. Minor gaps exist for common browser needs like explicit navigation/back, scrolling, or keyboard actions, but most SalonBiz tasks can likely be handled through click and type.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    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

    • DaySmart MCP server for ChatGPT, Claude and any AI agent: list appointments, book appointment, find client, update pet record and export sales in your own DaySmart account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to DaySmart yourself; Cotlet does not store your password and you need no DaySmart API key. About the official DaySmart API: DaySmart Salon and DaySmart Pet have no public API (checked 11 Oct 2026). DaySmart advertises scheduling API access only for its separate Appointments product. Setup and FAQ: https://cotlet.dev/integrations/daysmart-api-mcp-server

    • GlossGenius MCP server for ChatGPT, Claude and any AI agent: list appointments, book appointment, reschedule appointment, find client and get sales summary in your own GlossGenius account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to GlossGenius yourself; Cotlet does not store your password and you need no GlossGenius API key. About the official GlossGenius API: GlossGenius has no public API, developer docs, webhooks or MCP server (checked 24 Oct 2026). Its help center says it offers no direct integrations with accounting or reporting tools; data leaves only as reports and a client list CSV you download by hand. Setup and FAQ: https://cotlet.dev/integrations/glossgenius-api-mcp-server

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Connects AestheticsPro accounts to ChatGPT, Claude, and other AI agents through Cotlet, enabling appointment scheduling, client contact access, lead creation, and staff assignment with user approval.
      7
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects a signed-in Squire barbershop account to AI agents so they can list barbers, services, clients and waitlists, book, reschedule or cancel appointments, block barber time, and pull revenue reports. Write actions on appointments wait for user approval in the Cotlet console, and the same tools are reachable over MCP or a REST API.
      Elastic 2.0