Acuity Scheduling MCP server · unofficial, by Cotlet Let your AI agent work in your Acuity Scheduling account.
Cotlet is a cloud browser with a remote MCP server. It stays signed in to your Acuity Scheduling business account, so ChatGPT, Claude or any MCP client can work on the same screens you use: calendar, clients, availability and reports.
- Free 7-day trial, no card
- Unofficial, not affiliated with Acuity Scheduling
- Server URL
https://cotlet.dev/mcp/v1- Connection
- Streamable HTTP · OAuth or API key
- Works in
- ChatGPT, Claude, Claude Code, Cursor, Codex, n8n
Six appointment desk jobs
What can you ask your agent to do in Acuity Scheduling? Whatever your own login can do by hand.
-
-
Book Anna for a 60 minute massage on Friday afternoon.
-
Block Monday morning on my calendar for training.
-
How many appointments did each of us have last month, and how many were no-shows?
-
Which clients came in 3 times or more this year and have nothing booked?
-
Draft a note to the clients who canceled this week, offering a new time. Send nothing yet.
Remote MCP server
How does the Acuity Scheduling MCP server from Cotlet work?
Cotlet runs a remote MCP server that gives your AI agent a Cloud Browser: a Chrome that runs in the cloud and stays signed in to your Acuity Scheduling business account. Your AI client connects to the server and gets browser tools from it. Before its first step in Acuity Scheduling, the agent reads Cotlet's guide to Acuity Scheduling's screens. Then it opens secure.acuityscheduling.com in your Cloud Browser and works on the same screens you use.
- YOUR AI ChatGPT, Claude, Cursor, n8n or any MCP client
- COTLET MCP SERVER https://cotlet.dev/mcp/v1 Streamable HTTP · OAuth or API key
- YOUR CLOUD BROWSER Chrome in the cloud, signed in as you
- ACUITY SCHEDULING secure.acuityscheduling.com
| What | Answer |
|---|---|
| Server URL with OAuth sign-in | https://cotlet.dev/mcp/v1/connect for ChatGPT, Claude, Claude Code and Grok |
| Server URL with an API key | https://cotlet.dev/mcp/v1 for Codex, Cursor, Hermes Agent, n8n and other MCP clients |
| Transport | Streamable HTTP |
| Tools your agent gets | Browser tools to open, read, click, type, select, fill in forms, scroll, take screenshots and download files, plus a guide to Acuity Scheduling's screens |
| Where Acuity Scheduling runs | Your Cloud Browser, signed in with your own Acuity Scheduling login |
| What Cotlet stores | The signed-in session, encrypted. No password |
| Status | Unofficial. Cotlet is not affiliated with Acuity Scheduling |
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connect The same server and the same tools work in any web app you sign in to. Acuity Scheduling is one of them.
Set up once
How to connect Acuity Scheduling to your AI agent Three steps, no code.
You need the owner login of your Acuity Scheduling business account (or a team login with the access you want the agent to have), access to any sign-in code Acuity sends you, and a Cotlet account. The free trial gives you 2,000 credits for 7 days, no card.
-
Step 1
Sign in to Acuity Scheduling
Your business account, in your Cloud Browser.
-
Step 2
Connect your AI agent
Add the Cotlet server to ChatGPT, Claude or another client.
-
Step 3
Ask for a first job
Your agent asks before it books, moves or cancels.
We never see your Acuity Scheduling password, and bookings, moves, cancellations and client emails wait for your OK. Who can see your session
Any MCP client
Connect Acuity Scheduling to your AI agent
Step 1: sign in to Acuity Scheduling in your Cloud Browser
In the Cotlet console, open your Cloud Browser, go to secure.acuityscheduling.com and sign in with your usual email and password. If Acuity asks for a code, you enter it there yourself.
You type the password into Acuity Scheduling's own page. Cotlet does not see it and does not store it; it keeps only the signed-in session, encrypted. If Acuity Scheduling signs you out one day, your agent says so and sends you a link to sign in again.
Step 2: connect your AI agent
Pick the AI you already use. ChatGPT, Claude, Claude Code, Codex, Cursor, Grok, Hermes Agent, n8n and other MCP clients all work in the same signed-in Acuity Scheduling account.
Pick your AI above to see its steps.
How to connect Acuity Scheduling to ChatGPT
Do this on chatgpt.com in your browser. Cotlet then works in the ChatGPT desktop and phone apps too.
- Open Plugins in ChatGPT and click Add.
- Click Add custom MCP server. Not in the menu? Turn on Developer mode in Settings, Security and login, then come back.
- Paste the name
Cotletand the server URLhttps://cotlet.dev/mcp/v1/connect. Keep Authentication on OAuth. - Tick "I understand and want to continue" and click Create as a plugin.
- Click Connect Cotlet. A Cotlet page opens, click Allow access.
- In a new chat, type
@Cotletand pick it from the list. - Ask ChatGPT: "Are you signed in to Cotlet through MCP?" Then try a first Acuity Scheduling task: "List my Acuity appointments for tomorrow, by calendar."
ChatGPT asks "Allow ChatGPT to use Cotlet?" before some steps. Pick Always allow, or the chat waits for your click. On a Business, Enterprise or Edu workspace, an admin has to allow custom MCP servers first.
How to connect Acuity Scheduling to Claude
- Open Connectors in Claude and click Add. In the desktop app it is under Customize, Connectors.
- Click Add custom connector.
- Paste the name
Cotletand the URLhttps://cotlet.dev/mcp/v1/connect, then click Continue. - Keep the settings and click Add.
- A Cotlet page opens. Click Allow access.
- In a chat, click the plus button, then Connectors, and turn Cotlet on.
- Ask Claude: "Are you signed in to Cotlet through MCP?", then "Which Acuity clients have not booked in 3 months?". Claude asks before it uses a Cotlet tool the first time. Click Allow.
Claude's free plan allows one custom connector. On a Team or Enterprise plan, an owner adds Cotlet in Organization settings, Connectors, and you click Connect next to it.
How to connect Acuity Scheduling to Claude Code
Add Cotlet without a key, then sign in once in the browser:
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connectRun /mcp in Claude Code, pick cotlet and sign in to Cotlet. Prefer an API key, for example on a server? Create one in the Cotlet console and use:
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 \
--header "Authorization: Bearer $COTLET_API_KEY" How to connect Acuity Scheduling to Codex
Create an API key in the Cotlet console, put it in the COTLET_API_KEY environment variable and add this to ~/.codex/config.toml:
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY" How to connect Acuity Scheduling to Cursor
Create an API key in the Cotlet console, put it in the COTLET_API_KEY environment variable and add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
} How to connect Acuity Scheduling to Grok
Grok takes custom MCP servers on grok.com, per xAI's connectors documentation (checked 8 November 2026).
- Open grok.com/connectors and click New Connector.
- Pick Custom and paste the server URL
https://cotlet.dev/mcp/v1/connect. - Sign in to Cotlet when Grok asks, then click Allow access.
- Ask Grok: "Are you signed in to Cotlet through MCP?"
On Grok Business, an admin adds the connector first in the xAI console, under Grok Business, Connectors. The Grok chat inside X has no custom connector menu.
How to connect Acuity Scheduling to Hermes Agent
Add Cotlet to ~/.hermes/config.yaml in the format of the Hermes MCP config reference:
mcp_servers:
cotlet:
url: "https://cotlet.dev/mcp/v1"
headers:
Authorization: "Bearer ${COTLET_API_KEY}"
trust: untrustedPut COTLET_API_KEY in ~/.hermes/.env and check it with hermes mcp test cotlet. With trust: untrusted, Hermes runs reads at once and asks before every write. More on Hermes in our post on the Hermes Agent browser.
How to connect Acuity Scheduling to n8n
Use the MCP Client node, or the MCP Client Tool inside an AI Agent node:
- Server Transport: HTTP Streamable
- MCP Endpoint URL:
https://cotlet.dev/mcp/v1 - Authentication: Bearer Auth, with your Cotlet API key as the token
- Tools: let the AI Agent node use Cotlet's browser tools; it reads Cotlet's Acuity Scheduling guide first and works in your signed-in Acuity Scheduling account
Use it for work that should run on its own, such as a Monday list of regular clients with nothing booked, each with a draft note for you to approve.
Any other MCP client
Point the client at https://cotlet.dev/mcp/v1 over Streamable HTTP, with the header Authorization: Bearer <your Cotlet API key>. A client that supports OAuth sign-in can use https://cotlet.dev/mcp/v1/connect instead and needs no key. The full reference is in the MCP docs.
Step 3: ask for a first job
Pick one job you did by hand this week, ask for it, and check the result in your Acuity Scheduling calendar. For example: "Leo is off today. List his appointments, move each to someone free at the same time, and list the ones nobody can take. Ask me before each change." Your agent asks you before it books, moves or cancels an appointment, or emails a client.
No official MCP found
Does Acuity Scheduling have an MCP server? No Acuity MCP server was found.
No Acuity Scheduling MCP server or ChatGPT or Claude connector was found in Acuity's help center, its developer docs or the official MCP Registry (checked 20 Nov 2026).
- Acuity has a public API on the Premium or Powerhouse plan, webhooks on any plan, and apps on Zapier and Make.
- Cotlet works in your signed-in Acuity account, on the calendar, clients and availability you already use.
- The full picture with sources: Does Acuity Scheduling have an API or MCP server?
Checked 20 Nov 2026. Sources: Acuity Help: CSS, webhooks and APIs · Zapier: Acuity Scheduling integrations · MCP Registry search
Your login, your screens
Which Acuity Scheduling screens can your agent work in?
Your agent works on the screens your Acuity Scheduling login opens. An owner sees everything. A team member sees what their permissions allow.
Acuity Scheduling screens your agent can work in
Examples of what you can ask for
-
Calendar
- Tomorrow's appointments by calendar
- a booking
- a move
- blocked time
-
Clients
- A client's contact details
- past appointments and notes
-
Availability
- Open hours and blocked time for each calendar
-
Reports
- Appointments
- no-shows and payments for any period
Want the same jobs as API endpoints for n8n, Make or your own code? See Acuity Scheduling API with Cotlet.
Encrypted, revocable
Who can see my Acuity Scheduling session, and how do I stop it?
-
What Cotlet keeps
Your signed-in Acuity Scheduling browser profile, encrypted with AES-256-GCM, in Finland. No password.
-
What your agent sees
The same pages your Acuity Scheduling login shows. Nothing more.
-
When Acuity Scheduling signs you out
You get an email with a link and sign in again yourself.
-
How to stop it
Disable Acuity Scheduling for agents, reset the browser or delete the key, in the Cotlet console.
A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).
Asks first
Your agent asks before it changes anything Clients hear nothing until you say yes.
- 1
Finds the client
By name, phone or email.
- 2
Fits the service
Free times long enough for the appointment.
- 3
Asks for your OK
Before it books, moves or cancels an appointment, or emails a client.
- 4
Drafts the reply
Date, time and who, for you to send.
Your agent asks you before it books, moves or cancels an appointment, or emails a client. Client notes and blocked time are only seen by your team. Check each change in your Acuity Scheduling calendar.
| Action | Undo |
|---|---|
| Cancel an appointment | Not from Cotlet. Check Acuity's own rules before you allow it |
| Email a client | Not from Cotlet. Check Acuity's own rules before you allow it |
| Book or move an appointment | Check it in the Acuity calendar after the change |
| Client note, blocked time | Check it in Acuity after the change |
Pay as you go
What does Cotlet cost?
-
From $29
one-time pack of 5,000 credits, valid for 365 days, no subscription
-
50 credits
a day of Cloud Browser for agents
-
5 credits
a minute of agent work
-
7 days
free trial with 2,000 credits, no card
| Credits | Price, one time | Per 1,000 credits |
|---|---|---|
| 5,000 | $29 | $5.80 |
| 15,000 | $79 | $5.27 |
| 32,000 | $149 | $4.66 |
| 60,000 | $249 | $4.15 |
Cotlet is best for practitioners and studio owners on Acuity who want ChatGPT or Claude to handle bookings, schedule changes and weekly numbers without a developer.
- No Premium plan or API key needed
EU company, since 2019
Who runs Cotlet A company you can look up.
Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), working since 2019. The founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about Acuity Scheduling on Cotlet go to contact@cotlet.dev.
- Company
- Take Group sp. z o.o.
- Registered
- Poland, EU
- VAT
- PL6342984273
- Working since
- 2019
- Founders
- Bart Krawczyk and Jake Slugocki
Acuity Scheduling and AI agents: questions
Is this an official Acuity Scheduling integration?
No. Cotlet is independent and not affiliated with Acuity Scheduling. Your agent works through your own signed-in Acuity Scheduling account, the way you would by hand.
Which Acuity login should the agent use?
Your own owner or admin login. Your agent sees what that login sees.
What can the agent not do in Acuity?
Your agent cannot do more than your own Acuity login. Payments, refunds and your Acuity plan are jobs to keep in your own hands.
Can I use Acuity Scheduling with n8n?
Yes. n8n connects to Cotlet with its MCP Client Tool and a Cotlet API key, and runs the same jobs on a schedule.
Give your agent a seat at your Acuity front desk
Sign in once, connect ChatGPT or Claude, and hand over the first job today.
Try it free nowNo card. Takes about 5 minutes.