Breely API and MCP server Let your AI agent run the booking desk.

ToolWhat it doesAccess

• set_availability Read or set weekly hours, specific hours for a day, and event type groups for a person or bookable thing. writeAsks first

  Specific hours override the regular hours for one day or open a day you are usually closed. Bookable Things can carry a capacity, so a sauna for five is never booked by six. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → set_availability

  REST endpointPUT https://cotlet.dev/api/v1/breely/availability

  Parameters

  Parameters: set_availability

  Name	Type	Description
  action string required	string	One of `get`, `set_weekly`, `set_specific`, `set_group`. `list` and `get` only read.
  bookable string required	string	A Person or other Bookable Thing (room, chair, court, seat and so on).
  hours object	object	Weekly hours, or the date and hours that override them.
  group string	string	For `set_group`: the event type group and its own hours.

  Example input

  {
    "action": "action",
    "bookable": "bookable"
  }

  Example response

  {
    "bookable": "Anna",
    "date": "2026-11-28",
    "hours": [
      {
        "from": "10:00",
        "to": "14:00"
      }
    ],
    "saved": true
  }

• manage_blocked_time List, add or remove blocked time on the Breely calendar. writeAsks first

  Only time blocked in Breely can be removed here. Time blocked by a synced Google, Office 365 or iCloud event changes only in that calendar. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → manage_blocked_time

  REST endpointPOST https://cotlet.dev/api/v1/breely/blocked-time/manage

  Parameters

  Parameters: manage_blocked_time

  Name	Type	Description
  action string required	string	One of `list`, `create`, `delete`. `list` and `get` only read.
  bookable string	string	Person or Bookable Thing the time is blocked for.
  start string	string	ISO date and time.
  end string	string	ISO date and time.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "bookable": "Anna",
    "start": "2026-11-21T12:00",
    "end": "2026-11-21T13:00",
    "blocked": true
  }

• set_joint_appointments Let clients book an event type with two people at once, such as a couples massage. writeAsks first

  Turns on "Clients must pick two people to book with". Clients then see only times when both people are free. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → set_joint_appointments

  REST endpointPUT https://cotlet.dev/api/v1/breely/joint-appointments

  Parameters

  Parameters: set_joint_appointments

  Name	Type	Description
  event_type string required	string	The event type.
  people array required	array	Two or more people who offer it, each with the event type in their availability.

  Example input

  {
    "event_type": "event type",
    "people": "people"
  }

  Example response

  {
    "event_type": "Couples massage",
    "people": [
      "Anna",
      "Ben"
    ],
    "joint": true
  }

• set_waitlisting Turn on waitlisting for the account and on a booking form. writeAsks first

  Clients can then join a waitlist for an event type with no open times, watched for 30 days by default, or for a full class session. Breely notifies them when a spot opens. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → set_waitlisting

  REST endpointPUT https://cotlet.dev/api/v1/breely/waitlisting

  Parameters

  Parameters: set_waitlisting

  Name	Type	Description
  form string required	string	Form name, as Breely lists it under Forms.
  first_in_line boolean	boolean	For classes: offer the seat to the first client on the list.

  Example input

  {
    "form": "form"
  }

  Example response

  {
    "form": "Book a class",
    "waitlisting": true,
    "first_in_line": true
  }

• cancel_appointment Cancel a 1:1 appointment or several of one client's, remove a class attendee, or delete a class. writeAsks first

  Removing an attendee from a class in a series removes them from every class in that series. A cancellation reaches the client when automations are on, so the agent names the appointments and the setting first. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → cancel_appointment

  REST endpointPOST https://cotlet.dev/api/v1/breely/appointment/cancel

  Parameters

  Parameters: cancel_appointment

  Name	Type	Description
  target string required	string	One of `appointment`, `client_upcoming`, `class_attendee`, `class`.
  appointment string	string	The appointment or class, by client and date and time.
  client string	string	For `client_upcoming` and `class_attendee`: the client.
  send_automations boolean	boolean	Send your cancellation automations. Deleting a class always sends them.

  Example input

  {
    "target": "target"
  }

  Example response

  {
    "target": "appointment",
    "client": "Example Client",
    "appointment": "2026-11-20T15:00",
    "send_automations": true,
    "canceled": true
  }

ToolWhat it doesAccess

• edit_form_questions Read a form or add a question: text, date, yes/no, agree to terms, choices, file upload, signature, client login. writeAsks first

  A Client Login question lets clients see their bookings and package balances, signing in with Google, Apple or an emailed code. Section logic can send new clients to a meet and greet and returning clients straight to booking. The form is what clients book through, so changes wait for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → edit_form_questions

  REST endpointPATCH https://cotlet.dev/api/v1/breely/form-questions

  Parameters

  Parameters: edit_form_questions

  Name	Type	Description
  action string required	string	One of `get`, `add_question`, `set_section_logic`. `list` and `get` only read.
  form string required	string	Form name, as Breely lists it under Forms.
  question object	object	For `add_question`: type, label, required, and options or terms text.
  logic object	object	For `set_section_logic`: the yes/no question and the section each answer goes to.

  Example input

  {
    "action": "action",
    "form": "form"
  }

  Example response

  {
    "form": "Book a massage",
    "question": {
      "type": "signature",
      "label": "Sign to accept the cancellation policy",
      "required": true
    },
    "saved": true
  }

• manage_add_ons List a form's add-ons or create one that adds price or time to a booking. writeAsks first

  Add-ons belong to one form and show to clients booking through it and to admins booking with it. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → manage_add_ons

  REST endpointPOST https://cotlet.dev/api/v1/breely/add-ons/manage

  Parameters

  Parameters: manage_add_ons

  Name	Type	Description
  action string required	string	One of `list`, `create`. `list` and `get` only read.
  form string required	string	Form name, as Breely lists it under Forms.
  add_on object	object	For `create`: label, extra price, extra minutes, allow quantity, add only once per booking.

  Example input

  {
    "action": "action",
    "form": "form"
  }

  Example response

  {
    "form": "Book a massage",
    "add_on": "Hot stones",
    "price": 15,
    "minutes": 10,
    "saved": true
  }

• manage_automations List a form's automations, or add a confirmation, reminder, follow-up or receipt. writeAsks first

  Texts go only to clients who opted in. A reminder can ask the client to confirm, and a custom field can track the reply. Automations message your clients from then on, so every new one waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → manage_automations

  REST endpointPOST https://cotlet.dev/api/v1/breely/automations/manage

  Parameters

  Parameters: manage_automations

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`. `list` and `get` only read.
  form string required	string	Form name, as Breely lists it under Forms.
  trigger string	string	One of `scheduled`, `before_appointment`, `completed`, `canceled`, `rescheduled`, `form_submitted`, plus minutes, hours or days.
  channel string	string	One of `email`, `text`, `slack`, `phone_call`, `custom_field_update`, `webhook`.
  content string	string	The message, with fields such as client name and appointment time.

  Example input

  {
    "action": "action",
    "form": "form"
  }

  Example response

  {
    "form": "Book a massage",
    "trigger": "before_appointment",
    "offset": "24 hours",
    "channel": "text",
    "saved": true
  }

ToolWhat it doesAccess

• manage_packages List packages and purchased packages, create one, or change a client's balance or expiry. writeAsks first

  Clients need no code: a package applies to eligible bookings made with the same name and email. A balance change is money a client has paid for, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → manage_packages

  REST endpointPOST https://cotlet.dev/api/v1/breely/packages/manage

  Parameters

  Parameters: manage_packages

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `update_purchase`. `list` and `get` only read.
  package string	string	Package name, or the client's purchased package for `update_purchase`.
  rules object	object	For `create`: price, what it redeems for (appointments, minutes, dollar amount or a count per type) and the eligible event types.
  override object	object	For `update_purchase`: new balance or expiration date.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "package": "Five 60 min massages",
    "client": "Example Client",
    "redeemed": 3,
    "remaining": 2,
    "expires": "2027-03-31"
  }

• manage_subscriptions List subscriptions or create a recurring pack of appointments with its renewal rules. writeAsks first

  A subscription bills clients again on every renewal, so a new one waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → manage_subscriptions

  REST endpointPOST https://cotlet.dev/api/v1/breely/subscriptions/manage

  Parameters

  Parameters: manage_subscriptions

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  subscription string	string	Name, for `get` and `create`.
  rules object	object	For `create`: price, what it redeems for, renewal (weekly up to yearly), rollover, reset or keep, and any discount on other services.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "subscription": "90 min membership",
    "renews": "monthly",
    "price": 120,
    "unused_balance": "rollover",
    "extra_discount_percent": 20,
    "saved": true
  }

• manage_coupons List coupon codes or create single or multiple codes with a percent or fixed discount. writeAsks first

  A coupon lowers what clients pay, so the agent shows the discount, limit and expiry first. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → manage_coupons

  REST endpointPOST https://cotlet.dev/api/v1/breely/coupons/manage

  Parameters

  Parameters: manage_coupons

  Name	Type	Description
  action string required	string	One of `list`, `create`. `list` and `get` only read.
  code string	string	The code, for a single code.
  discount object	object	Percent or fixed amount, and the event types, packages or subscriptions it applies to.
  limit string	string	One of `unlimited`, `once_per_client`, or a total number of uses.
  expires string	string	ISO date, or empty for no expiry.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "code": "WINTER15",
    "discount": {
      "percent": 15,
      "applies_to": [
        "Massage, 60 min"
      ]
    },
    "limit": "once_per_client",
    "expires": "2027-01-31",
    "saved": true
  }

• manage_gift_certificates List gift certificates and balances, or create one as an admin. writeAsks first

  Useful for in-person sales or a complimentary certificate. Each one gets its own code, expiry and balance, and delivery emails the recipient. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → manage_gift_certificates

  REST endpointPOST https://cotlet.dev/api/v1/breely/gift-certificates/manage

  Parameters

  Parameters: manage_gift_certificates

  Name	Type	Description
  action string required	string	One of `list`, `create`. `list` and `get` only read.
  recipient object	object	For `create`: name and email.
  amount number	number	One of your values, or a custom amount.
  message string	string	Optional message.
  delivery string	string	Delivery preference.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "recipient": "Example Recipient",
    "amount": 100,
    "code": "GC-7Q2K",
    "delivered": true
  }

ToolWhat it doesAccess

• manage_invoices List or read invoices, create a draft with line items, or send it to the client. writeAsks first

  Statuses run Draft, Sent, Overdue, Paid; a paid invoice can no longer be edited. Creating and sending are separate calls, so you read the draft first. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → manage_invoices

  REST endpointPOST https://cotlet.dev/api/v1/breely/invoices/manage

  Parameters

  Parameters: manage_invoices

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `send`. `list` and `get` only read.
  invoice string	string	Invoice number, for `get` and `send`.
  client string	string	For `create`: the client.
  items array	array	For `create`: name, description, quantity and unit price per line, plus discounts or fees.
  due_date string	string	ISO date. Defaults to your invoice settings.

  Example input

  {
    "action": "create",
    "client": "Example Client",
    "items": [
      {
        "name": "Massage, 60 min",
        "quantity": 2,
        "unit_price": 90
      },
      {
        "name": "Hot stones",
        "quantity": 1,
        "unit_price": 15
      }
    ],
    "due_date": "2026-11-30"
  }

  Example response

  {
    "invoice": "1042",
    "client": "Example Client",
    "items": [
      {
        "name": "Massage, 60 min",
        "quantity": 2,
        "unit_price": 90
      },
      {
        "name": "Hot stones",
        "quantity": 1,
        "unit_price": 15
      }
    ],
    "total": 195,
    "status": "Draft"
  }

• record_payment Record a cash or bank transfer payment on an appointment or client. writeAsks first

  Uses Make Payment, Manual. Breely does not process the money; it records it. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → record_payment

  REST endpointPOST https://cotlet.dev/api/v1/breely/payments

  Parameters

  Parameters: record_payment

  Name	Type	Description
  appointment string required	string	The appointment or client, by client and date.
  amount number required	number	Amount received.
  note string	string	Cash, bank transfer or another note.

  Example input

  {
    "appointment": "appointment",
    "amount": 1
  }

  Example response

  {
    "client": "Example Client",
    "appointment": "2026-11-20T15:00",
    "amount": 90,
    "method": "manual",
    "recorded": true
  }

ToolWhat it doesAccess

• run_report Run a Breely report on clients, events, forms, packages and subscriptions, classes, payments, gift certificates or invoices. read

  Returns the rows of the report your user can see. Events carry their times, event type, who they were booked with and form or custom fields; Packages/Subscriptions carry status and balance left. It changes nothing and runs without asking.

  MCP callbreely_read → run_report

  REST endpointGET https://cotlet.dev/api/v1/breely/reports/run

  Parameters

  Parameters: run_report

  Name	Type	Description
  report string required	string	A saved report by name, or one of `clients`, `events`, `forms`, `packages_subscriptions`, `classes`, `payments`, `gift_certificates`, `invoices`, `last_month_bookings`, `revenue_per_event_type`, `revenue`.
  filters object	object	Filters and grouping, for example a date range or an event type.

  Example input

  {
    "report": "report"
  }

  Example response

  {
    "report": "revenue_per_event_type",
    "from": "2026-10-01",
    "to": "2026-10-31",
    "rows": [
      {
        "event_type": "Massage, 60 min",
        "bookings": 42,
        "revenue": 3780
      },
      {
        "event_type": "Massage, 90 min",
        "bookings": 18,
        "revenue": 2340
      },
      {
        "event_type": "Couples massage",
        "bookings": 6,
        "revenue": 1140
      }
    ]
  }

• set_custom_fields Add a private field to clients or appointments, or fill it in on one record. writeAsks first

  Fields live under Settings, Fields and are private to your team. A confirmation status field is one way to track reminder replies. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → set_custom_fields

  REST endpointPUT https://cotlet.dev/api/v1/breely/custom-fields

  Parameters

  Parameters: set_custom_fields

  Name	Type	Description
  action string required	string	One of `list`, `create`, `set_value`. `list` and `get` only read.
  on string	string	One of `client`, `appointment`.
  field string	string	Field name, for example Phone Call Summary.
  record string	string	For `set_value`: the client or appointment.
  value string	string	For `set_value`: the text to store.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "on": "appointment",
    "field": "Confirmed",
    "record": "Example Client, 2026-11-20T15:00",
    "value": "Yes",
    "saved": true
  }

• ban_client Ban a client from booking or submitting forms, with the message they see. writeAsks first

  The ban covers the client and their browser. It always waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callbreely_write → ban_client

  REST endpointPOST https://cotlet.dev/api/v1/breely/client/ban

  Parameters

  Parameters: ban_client

  Name	Type	Description
  client string required	string	Client name or email.
  message string required	string	What the client sees when they try to book.

  Example input

  {
    "client": "client",
    "message": "message"
  }

  Example response

  {
    "client": "Example Client",
    "banned": true
  }