Skip to main content
Glama

Breely MCP server

Connect Breely to ChatGPT, Claude and any AI agent through Cotlet.dev. Manage availability, blocked time, forms, invoices and client reports in your own signed-in Breely account. Write actions ask for approval by default.

What you can ask

Read revenue per service for last month.

Draft an invoice for two massages and a hot stones add-on, then show me before sending.

List blocked time for this week.

Related MCP server: Exercise.com 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 & Connectors → Create, with connector URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev. No API key needed.

Claude

Settings → Connectors → Add custom connector, with URL https://cotlet.dev/mcp/v1/connect, then 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 Breely 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 breely_agent.py serve

Or with Docker:

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

Tools: breely_guide, breely_status, breely_open, breely_read, breely_click, breely_type, breely_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 breely_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 breely_agent.py status    # is Breely ready in your Cotlet.dev account
python3 breely_agent.py guide     # Breely screens and sign-in link
python3 breely_agent.py read      # open Breely, read the page, close the browser
python3 breely_agent.py tools     # list Cotlet.dev tools
python3 breely_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from Breely users

Which Breely user should I connect?

Sign in with the user whose work the agent should do. The agent sees what that user can see in Breely.

Can the agent take card payments?

Online payments use the Stripe or Square account connected in Breely. The agent can send an invoice or record a cash or bank transfer payment.

Is Cotlet affiliated with Breely?

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

Learn more


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

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

Workflows on the hosted integration

The live integration page documents these 17 operations:

  • set_availability

  • manage_blocked_time

  • set_joint_appointments

  • set_waitlisting

  • cancel_appointment

  • edit_form_questions

  • manage_add_ons

  • manage_automations

  • manage_packages

  • manage_subscriptions

  • manage_coupons

  • manage_gift_certificates

  • manage_invoices

  • record_payment

  • run_report

  • set_custom_fields

  • ban_client

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
breely_clickB

Click a numbered element on the current Breely page.

Inputs: element (required).

breely_closeA

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

Inputs: no named parameters.

breely_guideA

How to work in Breely (bookings, availability, forms, invoices and client reports): its screens and the sign-in link. Call this first.

Inputs: task.

breely_openB

Open a Breely page in your signed-in Cloud Browser (default https://app.breely.com) to work with bookings, availability, forms, invoices and client reports.

Inputs: url.

breely_readA

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

Inputs: element.

breely_statusA

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

Inputs: no named parameters.

breely_typeB

Type text into a numbered field on the current Breely 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 maps to a distinct role: guide (instructions), status (readiness check), open/close (session lifecycle), and read/click/type (page interaction primitives). There is no meaningful overlap between any pair, and the 'call this first' hint on breely_guide further reduces ordering ambiguity.

    Naming Consistency4/5

    All seven tools share a uniform breely_ prefix and are short, lowercase, and single-token. The only minor deviation is that guide/status are nouns while open/click/read/type/close are verbs, but the pattern remains highly predictable.

    Tool Count5/5

    Seven tools is tightly scoped for a browser-automation wrapper: one onboarding pair, one session lifecycle pair, and three interaction primitives. Nothing feels redundant or missing at the count level.

    Completeness4/5

    The set covers the core browse loop (open, read, click, type, close) plus onboarding, which is enough to drive bookings, forms, and invoices. However, there is no explicit navigate/goto, scroll, or select-dropdown operation, so some flows depend on link-clicking or may dead-end on non-link controls.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Acuity Scheduling MCP server for ChatGPT, Claude and any AI agent: list appointments, check availability, book appointment, reschedule appointment, cancel appointment and block off time in your own Acuity Scheduling account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Acuity Scheduling yourself; Cotlet does not store your password and you need no Acuity Scheduling API key. About the official Acuity Scheduling API: Acuity Scheduling has a full REST API but no official MCP server (checked 17 Oct 2026). The API uses HTTP Basic auth with your user ID and API key, and Acuity says API access is available on the Premium plan (formerly Powerhouse), so Starter and Standard accounts have no key to give an agent. Setup and FAQ: https://cotlet.dev/integrations/acuity-scheduling-api-mcp-server

    • SimplePractice MCP server for ChatGPT, Claude and any AI agent: list appointments, accept appointment request, share intake documents, list outstanding balances, list claims, set appointment status and send secure message in your own SimplePractice account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to SimplePractice yourself; Cotlet does not store your password and you need no SimplePractice API key. About the official SimplePractice API: SimplePractice has no public API for practices (checked 27 Oct 2026). Its help center says it does not offer a public-facing API, and the only API, SimpleConnect, lets health plans and employee assistance programs request appointments with in-network clinicians. Setup and FAQ: https://cotlet.dev/integrations/simplepractice-api-mcp-server

    • Appointy MCP server for ChatGPT, Claude and any AI agent: book appointment, reschedule appointment, find free slots, list customers and cancel appointment in your own Appointy account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Appointy yourself; Cotlet does not store your password and you need no Appointy API key. About the official Appointy API: Appointy lists private API access only on its top Enterprise plan (checked 8 Nov 2026). On other plans it connects through a Zapier app whose only action creates a customer. Setup and FAQ: https://cotlet.dev/integrations/appointy-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
      Enables ChatGPT, Claude and other AI agents to work inside a signed-in Eversports Studio Manager account through Cotlet — viewing studio activities and sign-in lists, signing participants in, pausing or resuming memberships, and emailing invoices, with user approval before any change is saved. It runs as a hosted connector or a local stdio server that forwards tool calls to Cotlet.
      7
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents like ChatGPT, Claude, and Cursor to work inside a user's own signed-in Exercise.com account, viewing schedules, booking sessions, messaging clients, and handling invoices with approval steps. It runs as a hosted connector or a local stdio server that forwards tool calls to the hosted backend using a Cotlet API key.
      Elastic 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables ChatGPT, Claude, and other AI agents to manage appointments, customers, services, staff calendars, and notes in Setmore through natural language via Cotlet.dev.
      7
      Elastic 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents such as ChatGPT and Claude to manage ClinicSense scheduling, wait lists, payments, reports, and client emails through Cotlet.dev, with write calls requiring approval by default and excluding charting, SOAP notes, intake forms, and client files.
      7
      Elastic 2.0