SalonBiz API and MCP server Let your AI agent read the book and run the reports.

ToolWhat it doesAccess

• manage_appointment_book Read the appointment book for a day, book or move an appointment, or read the Wait List. writeAsks first

  `list` returns each appointment with its services, stylist, whether the client is new, the request reason and the confirmation status, which SalonBiz updates when a client answers a reminder. `wait_list` returns the clients waiting for an opening. Booking and moving change a client's visit, so the agent shows you the slot first. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonbiz_write → manage_appointment_book

  REST endpointPOST https://cotlet.dev/api/v1/salonbiz/appointment-book/manage

  Parameters

  Parameters: manage_appointment_book

  Name	Type	Description
  action string required	string	One of `list`, `book`, `move`, `wait_list`. `list` and `wait_list` only read.
  date string	string	ISO date. Defaults to today.
  stylist string	string	Only this service provider's column.
  client string	string	For `book` and `move`: the client.
  services array	array	For `book`: service names, one or more, each with its stylist.
  start string	string	For `book` and `move`: ISO date and time.
  location string	string	Salon location, for multi-location accounts. Leave empty for the one your login opens.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "date": "2026-11-14",
    "appointments": [
      {
        "time": "09:00",
        "client": "Example Client",
        "services": [
          "Cut and blow dry"
        ],
        "stylist": "Jamie",
        "new_client": false,
        "status": "confirmed"
      },
      {
        "time": "10:30",
        "client": "Sample Guest",
        "services": [
          "All-over color",
          "Gloss"
        ],
        "stylist": "Taylor",
        "new_client": true,
        "status": "unconfirmed"
      }
    ],
    "wait_list": 2
  }

• manage_online_booking Read or change which services clients can book or rebook online, with deposits, add-ons and policy. writeAsks first

  SalonBiz lets you choose which services are bookable and rebookable online (useful for complex color work), take pre-payments and deposits, capture a card and show the cancellation policy. A change shows on your booking page for every client, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonbiz_write → manage_online_booking

  REST endpointPOST https://cotlet.dev/api/v1/salonbiz/online-booking/manage

  Parameters

  Parameters: manage_online_booking

  Name	Type	Description
  action string required	string	`get` or `update`. `get` only reads.
  service string	string	For `update`: the service.
  fields object	object	For `update`: bookable, rebookable, online name, duration, price, deposit, and the recommended add-ons offered with it.

  Example input

  {
    "action": "update",
    "service": "All-over color",
    "fields": {
      "rebookable": true,
      "deposit": 25,
      "add_ons": [
        "Gloss",
        "Hair mask"
      ]
    }
  }

  Example response

  {
    "service": "All-over color",
    "bookable": true,
    "rebookable": true,
    "deposit": 25,
    "add_ons": [
      "Gloss",
      "Hair mask"
    ],
    "saved": true
  }

ToolWhat it doesAccess

• view_point_of_sale Read the tickets for a day or a client: services, add-ons, product recommendations and totals. read

  A SalonBiz ticket carries what happened in the chair: services, add-on services and the stylist's product recommendations. SalonBiz uses it to adjust inventory, update client history and calculate commission, and its frequency-of-visit info gives the date the client should book next. This tool reads; it never checks anyone out or takes a payment.

  MCP callsalonbiz_read → view_point_of_sale

  REST endpointGET https://cotlet.dev/api/v1/salonbiz/point-of-sales/view

  Parameters

  Parameters: view_point_of_sale

  Name	Type	Description
  date string	string	ISO date of the tickets. Defaults to today.
  client string	string	Only this client's tickets, with purchase history.
  location string	string	Salon location, for multi-location accounts. Leave empty for the one your login opens.

  Example response

  {
    "client": "Example Client",
    "tickets": [
      {
        "date": "2026-10-17",
        "services": [
          "Cut and blow dry",
          "Scalp massage"
        ],
        "products": [
          "Example shampoo"
        ],
        "total": 128
      }
    ],
    "next_visit_due": "2026-11-21"
  }

• view_inventory Read stock levels, low-stock products, product usage and open purchase orders. read

  Returns what SalonBiz counts on hand, with the products its automated reorder reminders flag and the purchase orders you have open, including empowered ordering for Aveda and Bumble and bumble. It reads only; orders stay with you.

  MCP callsalonbiz_read → view_inventory

  REST endpointGET https://cotlet.dev/api/v1/salonbiz/inventories/view

  Parameters

  Parameters: view_inventory

  Name	Type	Description
  filter string	string	`low_stock`, `all` or a brand or product name.
  location string	string	Salon location, for multi-location accounts. Leave empty for the one your login opens.

  Example response

  {
    "filter": "low_stock",
    "products": [
      {
        "product": "Example color conditioner",
        "on_hand": 3,
        "reorder_at": 6
      },
      {
        "product": "Sample styling cream",
        "on_hand": 1,
        "reorder_at": 4
      }
    ],
    "open_purchase_orders": 1
  }

• view_salon_payments Read SalonBiz Payments for a period: payments, deposits, gift card sales and membership billing. read

  SalonBiz Payments is the built-in processing, powered by PaySimple. This tool reads its revenue and reconciliation view; it never charges a card, refunds or changes a membership.

  MCP callsalonbiz_read → view_salon_payments

  REST endpointGET https://cotlet.dev/api/v1/salonbiz/salon-payments/view

  Parameters

  Parameters: view_salon_payments

  Name	Type	Description
  from string required	string	ISO start date.
  to string required	string	ISO end date.
  type string	string	Optional: `payments`, `deposits`, `gift_cards` or `memberships`.
  location string	string	Salon location, for multi-location accounts. Leave empty for the one your login opens.

  Example input

  {
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "from": "2026-11-01",
    "to": "2026-11-13",
    "type": "deposits",
    "deposits": [
      {
        "client": "Sample Guest",
        "service": "All-over color",
        "amount": 25,
        "date": "2026-11-12"
      }
    ],
    "total": 25
  }

ToolWhat it doesAccess

• view_reporting Run a SalonBiz report for a period and read its rows. read

  SalonBiz reports cover sales, productivity, inventory, marketing ROI, client behavior and future revenue, per location or consolidated. The agent runs the report your login can open and returns its rows as text. Nothing is changed.

  MCP callsalonbiz_read → view_reporting

  REST endpointGET https://cotlet.dev/api/v1/salonbiz/reportings/view

  Parameters

  Parameters: view_reporting

  Name	Type	Description
  report string required	string	The report by its name in SalonBiz, for example staff performance, retail sales per ticket, commission, client retention, marketing ROI or future revenue.
  from string required	string	ISO start date.
  to string required	string	ISO end date.
  location string	string	One location, or `consolidated` for all of them.

  Example input

  {
    "report": "report",
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "report": "Staff performance",
    "from": "2026-10-01",
    "to": "2026-10-31",
    "rows": [
      {
        "stylist": "Jamie",
        "service_sales": 9840,
        "retail_sales": 1260
      },
      {
        "stylist": "Taylor",
        "service_sales": 11320,
        "retail_sales": 2140
      },
      {
        "stylist": "Riley",
        "service_sales": 7410,
        "retail_sales": 880
      }
    ]
  }

• manage_marketing List email campaigns with their results, draft a campaign, or schedule it to a client segment. writeAsks first

  `list` returns opens, clicks and the revenue SalonBiz attributes to each campaign. A drafted campaign stays unsent; scheduling it reaches every client in the audience, so the agent shows the subject, audience and time first. Automations such as birthday and win-back emails stay as you set them. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonbiz_write → manage_marketing

  REST endpointPOST https://cotlet.dev/api/v1/salonbiz/marketing/manage

  Parameters

  Parameters: manage_marketing

  Name	Type	Description
  action string required	string	One of `list`, `draft`, `schedule`. `list` only reads.
  campaign string	string	Campaign name.
  template string	string	For `draft`: a SalonBiz email template to start from.
  audience string	string	For `draft` and `schedule`: the targeted client group, for example lapsed clients.
  send_at string	string	For `schedule`: ISO date and time.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "campaigns": [
      {
        "campaign": "Holiday gift cards",
        "sent": "2026-11-03",
        "opens": 412,
        "clicks": 58,
        "revenue": 1840
      },
      {
        "campaign": "We miss you",
        "sent": "2026-10-20",
        "opens": 156,
        "clicks": 21,
        "revenue": 960
      }
    ]
  }