Breely MCP Server

npx add-mcp 'https://cotlet.dev/mcp/v1/breely'

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

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

Breely publishes no public API and no MCP server. Its Help Center documents one integration route for other apps: a private Zapier invite link that starts actions elsewhere when an appointment is scheduled, canceled or rescheduled.

Breely publishes no public API, and its private Zapier link only reports appointment changes to other apps (checked 14 Nov 2026). Cotlet runs a hosted Breely MCP server with 17 tools that ChatGPT and Claude use in your own studio account. Cancellations, reminders and invoices wait for your OK.

• Free 7-day trial, no card
• Unofficial, not affiliated with Breely
• Page: https://cotlet.dev/integrations/breely-api-mcp-server

What can your AI agent do in Breely?

• Open hours and block time off
• Cancel a client's upcoming bookings
• Invoice a client, record a cash payment
• Check package balances
• Add a reminder that asks for a reply
• Read revenue per service

Does Breely have an MCP server or an API?

• The Zapier link sits under Features & Integrations, Other, Zapier; Breely is not in the Zapier marketplace.
• Breely says other apps cannot add appointments or clients to Breely through it.
• Form automations can call a webhook, a POST from Breely to a URL you set.
• No official ChatGPT or Claude connector was found on breely.com or in the Help Center.

What you need	Zapier link and webhooks	By hand	Cotlet
Ask ChatGPT or Claude to do the work	No connector	Copy and paste	Hosted MCP server
Know when a booking changes	Scheduled, canceled, rescheduled	Check the calendar	Read reports on a schedule
Change bookings, hours, forms, invoices	Nothing comes back in	One screen at a time	17 tools, writes after your OK
Read revenue and package reports	Not available	Reports page	run_report

Checked 14 Nov 2026. Sources: Help: Zapier Integration Details, Breely Help Center, Breely homepage, Help: Automations, Help: Reports, Help: Canceling appointments, Help: Setting up availability, Help: Blocking off time, Help: Joint appointments, Help: Form questions, Help: Add-ons, Help: Packages, Help: Subscriptions, Help: Coupon codes, Help: Gift certificates, Help: Invoicing, Help: Recording offline payments, Help: Waitlisting, Help: Banning clients, Help: Custom fields

How does the Breely MCP server work?

1. Sign in to Breely. Once, in a browser we host for you.
2. Connect your AI agent. One address in its settings.
3. Hand it the desk work. Draft the invoice, then approve it.

Your agent works in your own signed-in Cloud Browser. Writes, and anything that reaches a client, wait for your OK.

How to connect Breely to your AI agent

1. Sign in to Breely in a Cloud Browser. Open app.breely.com in your Cotlet Cloud Browser and sign in with your own Breely user.
2. Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Breely is served from the shared address https://cotlet.dev/mcp/v1 along with every other app you switch on, so you add one connector, not one per app. Turned Breely on after connecting? Refresh the connector and its 17 tools show up.

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: breely_read

All 17 Breely MCP tools

One tool per owner workflow in the Breely Help Center, in Breely's own words. Where a tool takes an action, list and get only read and the rest write and ask first.

Calendar and availability

Hours for each Person or Bookable Thing, blocked time, joint appointments, waitlists and cancellations.

• Set availability (set_availability, write, asks first): Read or set weekly hours, specific hours for a day, and event type groups for a person or bookable thing.
• Block off time (manage_blocked_time, write, asks first): List, add or remove blocked time on the Breely calendar.
• Set joint appointments (set_joint_appointments, write, asks first): Let clients book an event type with two people at once, such as a couples massage.
• Turn on waitlisting (set_waitlisting, write, asks first): Turn on waitlisting for the account and on a booking form.
• Cancel appointments (cancel_appointment, write, asks first): Cancel a 1:1 appointment or several of one client's, remove a class attendee, or delete a class.

Forms and automations

Clients book through forms, so questions, add-ons and the emails and texts they trigger all live on a form.

• Edit form questions (edit_form_questions, write, asks first): Read a form or add a question: text, date, yes/no, agree to terms, choices, file upload, signature, client login.
• Add booking add-ons (manage_add_ons, write, asks first): List a form's add-ons or create one that adds price or time to a booking.
• Set automations and reminders (manage_automations, write, asks first): List a form's automations, or add a confirmation, reminder, follow-up or receipt.

Packages, subscriptions and offers

Prepaid bundles, recurring packs, coupon codes and gift certificates. Each one changes what a client pays.

• Manage packages (manage_packages, write, asks first): List packages and purchased packages, create one, or change a client's balance or expiry.
• Manage subscriptions (manage_subscriptions, write, asks first): List subscriptions or create a recurring pack of appointments with its renewal rules.
• Create coupon codes (manage_coupons, write, asks first): List coupon codes or create single or multiple codes with a percent or fixed discount.
• Create gift certificates (manage_gift_certificates, write, asks first): List gift certificates and balances, or create one as an admin.

Invoices and payments

Draft and send invoices, and record cash or bank transfer payments. Card payments stay with your Stripe or Square connection.

• Create and send invoices (manage_invoices, write, asks first): List or read invoices, create a draft with line items, or send it to the client.
• Record payments (record_payment, write, asks first): Record a cash or bank transfer payment on an appointment or client.

Clients and reports

Reports are read only. Custom fields and bans change client records.

• Run reports (run_report, read): Run a Breely report on clients, events, forms, packages and subscriptions, classes, payments, gift certificates or invoices.
• Set custom fields (set_custom_fields, write, asks first): Add a private field to clients or appointments, or fill it in on one record.
• Ban clients (ban_client, write, asks first): Ban a client from booking or submitting forms, with the message they see.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/breely-api-mcp-server#tools

Who can see my Breely session, and how do I revoke it?

• What we store. Your signed-in Breely browser profile, AES-256-GCM encrypted, in Finland. Never your password.
• What your agent gets. The 17 Breely tools. The session cookie stays in the Cloud Browser.
• What the session sees. The calendar, clients, forms and invoices your Breely user can open, and nothing more.
• What no tool touches. Your Breely plan and billing, other users, calendar syncing and the Stripe or Square connection.
• If Breely signs you out. You sign in again yourself, in the same Cloud Browser.
• How to cut access. Disable Breely for agents in the console, or reset the Cloud Browser to drop the session.

Cotlet never sees or stores your password: you sign in to Breely yourself, and the agent only uses the session that leaves. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

What happens when Breely changes?

When a Breely page changes, Cotlet updates its Breely server, and your agent calls the same tools with the same inputs.

Features you switch on in Breely, such as Packages, Subscriptions, Invoices or Waitlisting under Features & Integrations, become usable by the agent once they are on.

If Breely signs you out, one click in the Cotlet console reopens the Cloud Browser so you can sign in again.

Approvals, undo and mistakes

1. Find the client. run_report or manage_invoices list.
2. Build the draft. Two massages and hot stones.
3. Show you the total. $195, before saving.
4. Save, then send on your OK. manage_invoices creates the draft; sending is a second call.

Action	How to put it right
Hours, blocked time, custom fields	Call the same tool again with the earlier values
A draft invoice	Change it before it is sent; a paid invoice can no longer be edited
A coupon or package balance	Change the limit, expiry or balance back
A canceled appointment	The client got the cancellation if automations were on: rebook and tell them
A new automation	Messages already sent stay sent: switch it off and follow up

All 16 write tools ask first: by default you confirm each call, and you can switch that off per tool. The read tool, run_report, runs at once.

MCP call:

{
  "name": "manage_invoices",
  "arguments": {
    "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"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/breely/invoices/manage \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"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"}'

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"
}

The example bills two 60 min massages at $90 and one hot stones add-on at $15: $195, saved as a draft. A cron job or n8n flow makes the same call over REST at /api/v1/breely with the same key and price, in JSON. Failed calls are free.

How much does the Breely MCP server cost?

About $15 a month for a two-therapist studio with about 60 bookings a month, 2,500 credits. Your Breely plan stays as it is.

Job	Calls	Credits
Morning check of the day's bookings	1 × 26	260
Blocked time and hour changes	1 × 12	120
Cancellations and reschedule follow-ups	1 × 10	100
Invoices and cash payments	2 × 15	300
Package balances and gift certificates	1 × 8	80
Weekly revenue and package reports	2 × 4	80
New coupon, reminder or form change	2 × 3	60
Cloud Browser, 30 days		1,500
Total	100 calls	2,500

The smallest pack is 5,000 credits for $29. Most of a quiet month is the Cloud Browser; a busier studio adds calls, not days.

• Free 7-day trial, no card
• 10 credits per successful call, MCP or REST
• 50 credits a day for the Cloud Browser
• Your Breely plan applies as it is

Credit packs are one-time purchases, not a subscription. The month above is our own example, not measured customer usage.

Breely MCP server: other ways to connect

Option	What it does	Where it stops
Breely Zapier link	Starts a Zap when an appointment is scheduled, canceled or rescheduled.	Private invite link; other apps cannot add appointments or clients to Breely.
Form automation webhooks	Breely posts form and booking data to a URL you set.	Outgoing only, per form; you host whatever receives it.
Report exports	Breely's Reports page with filters, grouping and export.	By hand, while you are at the desk.

If all you need is to copy new bookings into a mailing list, the Zapier link already does that. Cotlet fits when you want ChatGPT, Claude or a script to read and change things inside Breely, from your own login, with nothing to host.

Who runs Cotlet

Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), operating since 2019 and run by its founders Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Breely tools: contact@cotlet.dev.

Breely MCP server: questions

How do I get access?

Sign up free at https://cotlet.dev/signup?app=breely, turn on Breely under Integrations in the console and sign in at https://app.breely.com/ in your Cloud Browser. Then connect your AI agent and ask it about this week. The trial needs no card.

Does Breely have an API?

No. Breely publishes no public API (checked 14 Nov 2026). Its Help Center documents a Zapier integration through a private invite link that triggers actions in other apps when an appointment is scheduled, canceled or rescheduled; other apps cannot add appointments or clients to Breely. No Breely MCP server or official ChatGPT or Claude connector was found. Cotlet does not need one: it works in your own signed-in Breely account.

Can the agent take card payments in Breely?

No. Online payments run through the Stripe or Square account you connect in Breely, and no Cotlet tool changes that connection. The agent can send an invoice the client pays online, or record a cash or bank transfer payment.

Does the agent change synced Google, Office 365 or iCloud events?

No. Breely shows time blocked by a synced calendar but cannot edit it; you change it in that calendar. The agent adds and removes only time blocked in Breely itself.

Which Breely user should I sign in with?

The user whose work the agent should do. It sees only what that user can see in Breely, so a team member without access to invoices gives the agent no invoices either.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 17 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

Is Cotlet affiliated with Breely?

No. Cotlet is independent and not affiliated with Breely.

---

Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.