Setmore MCP Server

Bookings, customers and staff calendars in your Setmore account.

Hosted MCP Server

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

Installs into Claude Code, Codex, Cursor and more

Documentation

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

Setmore API and MCP server: Let your AI agent keep the Setmore calendar straight.

Setmore has no MCP server (checked 27 Oct 2026). Its API is open to Pro accounts after you email api@setmore.com and the team approves the use case, and it has 10 operations: staff, services, time slots, customers, booking, a date-range list and labels. Cotlet runs 15 Setmore tools hosted, over MCP for agents and REST for scripts, on Free or Pro.

Bookings, customers and staff calendars in your Setmore account. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.

MCP setup REST API guide

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

What can you automate in Setmore?

Send tomorrow's schedule per person
Label no-shows and note them
Move bookings when someone is out
Block lunch and prep time
Book requests from emails and texts
Count bookings by service each month

Does Setmore have an MCP server or an API?

Access comes as a refresh token Setmore emails you. There is no sandbox: "all requests are made against live accounts".
The published API has no operation to reschedule or cancel, though the help center FAQ says it can. Customer notes, Events and Reports are not in it either.
Zapier works on Free too, with 6 triggers and 2 actions (create an appointment, create a contact), for service appointments only, not classes.

What you need	Setmore API (Pro)	Zapier	Cotlet
Read a day of the calendar	Yes, by date range	Triggers only	Yes, per person
Book an appointment	Yes	Yes	Yes, after your OK
Reschedule or cancel	Not in the docs	No	Yes, after your OK
Labels and customer notes	Labels only	No	Both
Block time and pull reports	No	No	Yes
What you need first	Pro plus an approval email	Free or Pro	Free or Pro

Checked 27 Oct 2026. Sources: Setmore API reference, Request Access to the Setmore API (Setmore Help Center), Zapier (Setmore Help Center), Setmore Appointments on Zapier, Setmore pricing

How does Cotlet connect to Setmore?

Sign in to Setmore. Use your own account in its Cotlet Cloud Browser.
Choose MCP or REST. Connect your agent or create a Cotlet API key.
Run your workflow. Ask your agent or send an HTTP request.

We never keep your Setmore password, and no booking, move or cancellation a customer would get an email about is saved before you approve it.

Connect Setmore to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

Sign in to Setmore in a Cloud Browser. Create a Cotlet account, open Setmore in its Cloud Browser, sign in with your own Setmore login (Free or Pro) and press Enable for agents.
Add the Cotlet address. Put https://cotlet.dev/mcp/v1 into your agent's MCP server or connector settings.
Allow the connection. Chat apps open a Cotlet sign-in page. Code editors, n8n and scripts use an API key from the console instead.

https://cotlet.dev/mcp/v1 is the one address for all your Cotlet apps, Setmore among them. If you enable Setmore after connecting, refresh the connector so its tools appear.

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"

ChatGPT:

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

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: setmore_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: setmore_write

How to use the Setmore REST API

Create your Cotlet API key

Create a Cotlet API key with access to Setmore and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Connect Setmore in Cotlet and enable it for agents. Account access: Your own Setmore account (Free or Pro) in the web app.

Make your first Setmore API request

REST:

curl https://cotlet.dev/api/v1/setmore/services \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read services and apply the operation limits

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "setmore",
  "tool": "list_services",
  "result": {
    "services": [
      {
        "service_id": "svc_8f21c4",
        "name": "Massage, 60 min",
        "category": "Massage",
        "duration_minutes": 60,
        "cost": 80,
        "staff": [
          "Anna",
          "Ben"
        ]
      },
      {
        "service_id": "svc_a19d03",
        "name": "Consultation, 30 min",
        "category": "Consultations",
        "duration_minutes": 30,
        "cost": 0,
        "staff": [
          "Anna"
        ]
      }
    ]
  }
}

Lists the services and classes set up in your account, grouped by the categories you use on your Booking Page. Use service_id from each item in list_available_slots, create_appointment and get_appointment_report.

Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.

Setmore workflows for agents and automations

Tool	Connect through	Example workflow
n8n	HTTP Request	Appointments in a date range with customer, service, team member, time and label. Use `list_appointments` in your configured business report.
Make	HTTP > Make a request	One appointment: customer, service, team member, start and end, label and where it was booked. Use `get_appointment` in your configured business report.
Python or Node.js	REST API	Appointment history from Reports, filtered by date range, service, class or team member. Use `get_appointment_report` in your configured business report.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads Setmore; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

Setmore API endpoints and MCP tools

Calendar and appointments

Setmore emails the customer about a booking, a move or a cancellation unless that email is off in Settings > Notifications. A label reaches nobody.

List appointments (list_appointments, read): Appointments in a date range with customer, service, team member, time and label.
Get appointment (get_appointment, read): One appointment: customer, service, team member, start and end, label and where it was booked.
List available slots (list_available_slots, read): Open times for a service on a day, based on working hours and existing bookings.
Create appointment (create_appointment, write, asks first): Book a service for a customer. Setmore emails the confirmation unless you turned it off.
Reschedule appointment (reschedule_appointment, write, asks first): Move an appointment to a new time or team member. The customer is emailed unless you turned it off.
Cancel appointment (cancel_appointment, write, asks first): Delete an appointment from your calendar. The customer is emailed unless you turned it off.
Set appointment label (set_appointment_label, write): Track status with a label such as Confirmed or No-Show. Only you and your team see it.

Blocked time

Events cover blocks within one day. Time Off for longer absences stays in Settings > Your team.

Block time (block_time, write): Add an Event to the calendar so customers cannot book that time.
Delete event (delete_event, write, asks first): Delete an Event from the calendar and free the time.

Customers and notes

Notes are private to your team. Block Customer is not a tool; it needs Pro and stays your call.

Find customer (find_customer, read): Search customers by name, email or phone.
Get customer (get_customer, read): Customer profile: contact details, your private notes and past and upcoming appointments.
Add customer note (add_customer_note, write): Add a private note to a customer profile. The customer does not see it.

Services, team and reports

Reports exist only in the web app, so mobile-only teams get them here. Keep each range to 3 months.

List services (list_services, read): Services and classes with category, cost, duration and the team members who offer them.
List staff (list_staff, read): Team members with the services they offer and their working hours.
Get appointment report (get_appointment_report, read): Appointment history from Reports, filtered by date range, service, class or team member.

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

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

What we store. Your signed-in Setmore profile, encrypted with AES-256-GCM, in Finland. Never the password.
What your agent gets. 15 Setmore tools. No cookie and no login.
What the session sees. What your Setmore user sees: a Standard user gets less than the Owner or an Admin.
What no tool touches. Payments, Block Customer, Time Off, notifications and account settings.
If Setmore signs you out. We email you a sign-in link. You sign in yourself, we never do.
How to cut access. Disable for agents, reset the browser or delete the key. The next call fails.

Clinics on Setmore Health sign a BAA with Setmore. Cotlet signs no BAA and makes no HIPAA claim, so keep patient records out of the notes your agent writes. The Cotlet site has A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results); there is no SOC 2 report or third-party pentest yet.

Is it against Setmore's terms? Account safety

engage in any systematic retrieval of content or information from the Site to create or compile, directly or indirectly, a collection, compilation, database, or directory, whether through the use of robots, spiders, automatic devices or manual processes

Setmore Terms of Use, Rules of Conduct (undated, read 27 Oct 2026)

That rule is about copying Setmore into a database, not about an assistant working in your own calendar, and nothing in the terms bans tools acting for you. The Termination section still lets Setmore close any account "for any or no reason, without notice". We found no public case of a Setmore account closed over automation (checked 27 Oct 2026).

How we keep your account looking like you:

Your own Setmore login, typed in by you
One Cloud Browser with a steady IP and cookies, like the front desk computer
Bookings, moves, cancellations and deleted events wait for your OK
No tool copies the whole customer list out of Setmore
If Setmore objects, we pause the Setmore tools for everyone within 24 h

Each move sends the customer an update email. When a whole day changes, approve the plan first so nobody gets two emails for one booking.

What happens when Setmore changes?

12 h between tests of the Setmore calendar, customer and report reads
24 h between tests of bookings and moves a customer would get an email about
$0 for a call to a Setmore tool paused for a fix

Setmore's Android app says "We're shipping new features monthly"; its last update was on 20 Oct 2026, and the API help article was rewritten on 30 Jul 2026. When a screen moves, we repair the tool and keep its name. status.cotlet.dev checks the site, console and API every 3 minutes.

Approvals, undo and mistakes

Blocks the day. An Event over the absent hours, so the Booking Page stops offering them.
Finds new slots. A colleague who offers the service the same day first, with the full service length.
Waits for your OK. Each move waits in your Cotlet console, with the number of update emails Setmore will send.
Reports back. Who moved, to whom, and the customers you need to call.

Action	Undo
Book an appointment	Cancel it; the confirmation email may have gone out
Reschedule an appointment	Move it back; the customer gets a second email
Cancel an appointment	Book again; the customer already has the cancellation email
Set a label	Set the old one back; nobody saw it
Block time	delete_event frees the slot

4 of the 7 write tools ask first. set_appointment_label, add_customer_note and block_time run at once, because a label, a private note or an Event with no guests reaches no customer. Reads run at once. For a scheduled run you can switch the wait off per tool.

Setmore keeps double booking off by default and never allows it on the Booking Page, so a slot taken online during the run makes the agent look again instead of overlapping.

MCP call:

{
  "name": "create_appointment",
  "arguments": {
    "service_id": "svc_8f21c4",
    "start": "2026-10-16T15:00:00-04:00",
    "customer": {
      "name": "Sam Client",
      "email": "client@example.com"
    },
    "staff_id": "stf_3a90de"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/setmore/services/svc_8f21c4/appointments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-10-16T15:00:00-04:00","customer":{"name":"Sam Client","email":"client@example.com"},"staff_id":"stf_3a90de"}'

Response:

{
  "appointment_id": "apt_51d7e2b9",
  "status": "booked",
  "service": "Massage, 60 min",
  "staff": "Anna",
  "start": "2026-10-16T15:00:00-04:00",
  "end": "2026-10-16T16:00:00-04:00",
  "customer_id": "cus_7c04a1",
  "confirmation_email": "sent"
}

A cron job or a booking form handler can reach the same tools over REST at /api/v1/setmore, with one key and one price. A call your Setmore user is not allowed to make returns an error and costs nothing. Every tool row above lists its REST path.

How much does the Setmore MCP server cost?

About $30 a month for one studio with 3 team members, 5,250 credits. Works on Setmore Free; Pro is $12 a user a month, or $5 billed yearly.

Job	Calls	Credits
Tomorrow's schedule per person, daily	2 × 30	600
Label no-shows and note them, each workday	6 × 26	1,560
Book requests from email and texts	3 × 40	1,200
Lunch blocks for the week	5 × 4	200
One sick day, 6 bookings moved	15 × 1	150
Bookings by service and person, monthly	4 × 1	40
Cloud Browser, 30 days		1,500
Total		5,250

Free 7-day trial, no card
10 credits per successful call, MCP or REST
50 credits a day for the Cloud Browser
No Setmore Pro plan or API approval needed

The month is our example: 3 team members, about 40 booking requests, a no-show check after each of 26 workdays, weekly lunch blocks, one sick day and one monthly report. Setmore publishes no typical size; most of its users have 1 to 10 employees (Enlyft) and Free allows 4 users. Dollars at the $29 pack rate.

Setmore MCP server on GitHub, Zapier or hosted: which to use

Option	What it does	Where it stops
shashaBot/setmore-sdk	A TypeScript SDK for the official API, marked "WIP". 0 stars, last push 6 Jan 2023.	Needs an approved Pro refresh token; no MCP, so no reschedule or notes.
lelizondo23/setmore_api	A Ruby wrapper for the same API. 0 stars, last push 8 Apr 2020.	Same limits, no license, unmaintained.
Live Receptionist	Human receptionists answer your calls and book into Setmore.	$99 a month, US only, and your own agent cannot hand it work.

If you build your own booking flow and have Pro, ask Setmore for API access. If new bookings only need to reach another app, Zapier covers it on Free. If your agent should read the calendar, move bookings, label no-shows and pull reports, Cotlet does that hosted.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet: a software company registered in Poland, EU (VAT PL6342984273), in business since 2019. The founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the Setmore tools.

Setmore API and MCP: questions

How do I get access?

Sign up free at https://cotlet.dev, open Setmore under Integrations in the console and sign in to Setmore in its Cloud Browser. The trial begins when you sign up and needs no card.

How do I connect Setmore to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Setmore once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Setmore account through Cotlet, in their phone apps too.

What can ChatGPT do in Setmore?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Setmore: get a daily schedule summary; mark no-shows and note repeat offenders; bulk reschedule appointments when a team member is out. You ask in plain words, and anything that reaches other people waits for your OK first.

Do I need the Pro plan or API approval?

No. Cotlet works in your own Setmore account on Free or Pro and needs no email to api@setmore.com. Setmore's own API requires a Pro account and approval by email (checked 11 Oct 2026).

Will customers get emails when my agent books, moves or cancels?

Yes, as when you do it by hand: Setmore emails the provider and the customer about booked, rescheduled and canceled appointments unless you turned those emails off in Settings > Notifications. Each of those calls asks for your OK by default.

Does Setmore have webhooks?

No. The API sends nothing out, and Zapier's 6 triggers (new, updated and deleted appointments and contacts) are the only events Setmore offers. To react to changes, run your agent on a schedule and read the calendar.

Does it work with class bookings?

For reading, yes: list_services shows classes and get_appointment_report filters by class. The booking tools book service appointments; customers still sign up for classes on your Booking Page.

Is the MCP server different from the REST API?

Only in how you call it. Both have the same 15 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and form handlers use REST.

Is Cotlet affiliated with Setmore?

No. Cotlet is independent and not affiliated with Setmore or AnywhereWorks.

Can I use the Setmore API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.

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.