Vagaro has an official public API, but it is limited and off by default (checked 11 Oct 2026). Cotlet is a hosted MCP server and REST API for Vagaro with 15 endpoints (8 read, 7 write): your AI agent signs in as you and does the work.
Vagaro has an official public API, but it is limited and off by default (checked 11 Oct 2026). You request access with a form, Vagaro says activation can take up to seven business days, and it is only for businesses that use Vagaro Credit Card Processing and are not on the free trial. The reference covers locations, employees, customers and appointments, and appointments can only be retrieved: no booking, rescheduling, cancelling, waitlist, Connect messages or review replies.
What Vagaro's own tools do compared with Cotlet
Task
Vagaro official
Cotlet
List locations
YesLocations section, after approval
Yes
List appointments
PartlyRetrieve Appointments needs an appointmentId or a customerId, after approval
Yes
Find a client
PartlyRetrieve Customer needs a customerId, after approval
Cotlet is best for salon, spa and studio owners who want their AI agent to handle bookings, the waitlist, Connect messages and review replies without running or fixing a server.
Daily schedule and gap summary Runs: Daily
What does tomorrow look like at the Main Street location? Flag any gaps longer than an hour. Your agent calls list_locations and list_appointments.
Fill a cancelled slot from the waitlist Runs: Daily
A 2pm slot with Alex just opened tomorrow. Offer it to the first person on the waitlist who wants a haircut. Your agent calls list_waitlist and notify_waitlist.
Alex is out sick today. Move each of her appointments to another stylist who offers the same service today, or to Alex's next free slot this week if nobody can take it. Show me the plan first and list anyone you could not place. Your agent calls list_appointments, list_services, search_availability and reschedule_appointment.
Every Monday, reply to last week's unanswered Vagaro reviews at both locations: thank 4 and 5 star reviewers by name and mention the service they had, and only draft replies to anything below 4 stars for me to read first. Your agent calls list_locations, list_reviews and reply_to_review.
Answer client messages in Connect Runs: Daily
Answer every unread client message in Connect that asks about prices, using our service menu. Your agent calls list_conversations, list_services and reply_to_client.
Endpoints
What is the Vagaro API?
Cotlet's Vagaro API exposes 15 endpoints for your own Vagaro account: list locations, list services, list appointments, search availability, find client, list waitlist, list conversations, list reviews, book appointment, reschedule appointment, cancel appointment, add to waitlist, notify waitlist, reply to client and reply to review. The list_locations endpoint returns your business locations with address, time zone and phone. Each endpoint takes simple JSON inputs like location_id, provider_id or service_id and works both as an MCP tool for agents and as a REST call for scripts.
Your business locations with address, time zone and phone.
read
Returns every location of your Vagaro business. Use location_id from each item in the other calls. Multi-location businesses read one location per call.
Service menu of a location with duration, price and who performs each service.
read
Returns the services of one location with duration, price and the providers who perform them. Use service_id in search_availability and book_appointment. Prices are the menu prices shown in Vagaro.
POST /api/v1/vagaro/list_services
Input
Input: list_services
Parameter
Type
Description
location_id
string
Location ID from list_locations. Default: your main location.
Appointments in a date range with client, service, provider and status.
read
Returns appointments of one location between two days, ordered by start time. Filter by provider to read one person's day. Each item has the client, service, provider, status and price shown on the calendar. This reads the calendar by date, which the official API cannot do.
POST /api/v1/vagaro/list_appointments
Input
Input: list_appointments
Parameter
Type
Description
location_id
string
Location ID from list_locations. Default: your main location.
from required
date
First day, inclusive.
to
date
Last day, inclusive. Default: same as from.
provider_id
string
Only this service provider.
status
string
Only appointments with this status, as Vagaro shows it. Default: all.
Open slots for a service, optionally with one provider, in a date range.
read
Returns open start times for one service in a date range, per provider. Use a start from the result in book_appointment or reschedule_appointment so the booking lands on a free slot.
POST /api/v1/vagaro/search_availability
Input
Input: search_availability
Parameter
Type
Description
location_id
string
Location ID from list_locations. Default: your main location.
Search clients by name, email or phone; returns contact details, tags and last visit.
read
Searches your customers by name, email or phone and returns contact details and tags. Use client_id in book_appointment and add_to_waitlist. The official API needs a customer ID up front; this finds the ID from what you know.
Clients on the waitlist with the service, provider and day they want.
read
Returns the waitlist of one location. Each entry has the client, the service and provider they asked for and the day. Use entry IDs in notify_waitlist. Which alerts Vagaro sends on its own depends on your waitlist mode under Online Appointment Rules.
POST /api/v1/vagaro/list_waitlist
Input
Input: list_waitlist
Parameter
Type
Description
location_id
string
Location ID from list_locations. Default: your main location.
Client chats in Connect by Vagaro with the last message and unread status.
read
Returns your Connect chats with clients, most recent first, with the last message and whether it is unread. Set unread_only to see what needs an answer. Replies to appointment notifications do not appear here.
POST /api/v1/vagaro/list_conversations
Input
Input: list_conversations
Parameter
Type
Description
unread_only
boolean
Only conversations with unread client messages.
limit
integer
1 to 50. Default: 20.
Example response
{
"conversations": [
{
"conversation_id": "cv_2290",
"client": "Maya Brooks",
"unread": true,
"last_message": "How much is a cut with Alex?",
"updated_at": "2026-10-13T16:02:00-07:00"
}
]
}
POST
list_reviews
Client reviews from your listing page with rating, text and whether you replied.
read
Returns the reviews posted on your Vagaro listing page, newest first, with rating, text and whether you replied. Use unanswered_only to skip reviews you already answered. You cannot remove a customer review in Vagaro, so this tool only reads them.
POST /api/v1/vagaro/list_reviews
Input
Input: list_reviews
Parameter
Type
Description
location_id
string
Location ID from list_locations. Default: your main location.
Books one client for one service with one provider at a start time from search_availability. Returns the appointment, its end time and price. The booking appears on the Vagaro calendar like one made by staff. By default you confirm each call; you can switch that off for this tool.
POST /api/v1/vagaro/book_appointment
Input
Input: book_appointment
Parameter
Type
Description
client_id required
string
Client ID from find_client.
service_id required
string
Service ID from list_services.
provider_id required
string
Service provider ID.
start required
datetime
Slot start from search_availability, ISO 8601 with time zone.
Moves one appointment to a new start time and optionally a new provider, the same change as dragging it on the calendar. Returns the old and new times. Pick the new start from search_availability. By default you confirm each call; you can switch that off for this tool.
Cancel a client's appointment from the calendar, optionally notifying the client.
asks first write
Cancels one appointment, as Change Status then Cancel does on the Vagaro calendar. Set notify_client to tell the client. Refunds of prepayments and cancellation fees are not part of this tool; handle those in Vagaro. By default you confirm each call; you can switch that off for this tool.
POST /api/v1/vagaro/cancel_appointment
Input
Input: cancel_appointment
Parameter
Type
Description
appointment_id required
string
Appointment ID from list_appointments.
notify_client
boolean
Tell the client about the cancellation. Default: true.
Put a client on the waitlist for a service, provider and day.
asks first write
Adds a client to the waitlist of a location for one service and day, as Vagaro lets staff do by hand. The date tells Vagaro when to notify the client. Returns the entry ID for list_waitlist. By default you confirm each call; you can switch that off for this tool.
POST /api/v1/vagaro/add_to_waitlist
Input
Input: add_to_waitlist
Parameter
Type
Description
location_id
string
Location ID from list_locations. Default: your main location.
Offers an open slot to the waitlist entries you pick, like choosing a client by hand in the You Pick mode. Returns how many clients were alerted. Clients receive the alert, so it reaches people outside your account. By default you confirm each call; you can switch that off for this tool.
Send a message to a client in Connect by Vagaro, optionally with your booking link.
asks first write
Sends a message in an existing Connect chat. Set include_booking_link to add your appointment booking link. Once a client has closed a chat, Vagaro needs a messaging plan on your side before you can keep replying. By default you confirm each call; you can switch that off for this tool.
POST /api/v1/vagaro/reply_to_client
Input
Input: reply_to_client
Parameter
Type
Description
conversation_id required
string
Conversation ID from list_conversations.
body required
string
Message text.
include_booking_link
boolean
Attach your appointment booking link. Default: false.
Post a public business reply under a customer review.
asks first write
Posts your reply under one review. The reply is public to other Vagaro users, the customer is notified, and the customer cannot comment again. There is no edit tool; edit or delete a reply in Vagaro on the web, tablet, Pay Desk or PayPro. By default you confirm each call; you can switch that off for this tool.
How do I connect Vagaro to Claude Code, Codex or Cursor?
Connecting Vagaro takes three steps: request access, sign in to Vagaro once, then add one MCP server or call the REST API with the same key.
Connect Vagaro over MCP
1
Create an account
Sign up and add Vagaro in the console. Your API key is there too.
2
Sign in to Vagaro once
Open the connect page from the console and sign in to Vagaro the way you always do. We keep the session, never your password, and you can revoke it anytime.
Paste the snippet for your client. The same server and key serve every app you connect, so you do this once.
4
Ask your agent
Prompt
What does tomorrow look like at the Main Street location? Flag any gaps longer than an hour.
Ask in plain words. Your agent finds the Vagaro tools on the server and calls them for you; anything that reaches other people waits for your OK unless you switch that off for a tool.
Call Vagaro over REST
1
Export your API key
Shell
export COTLET_API_KEY="cotlet_..."
Your scripts use the same API key as your agent. Keep it in an environment variable, never in your code.
2
Call a tool
curl
curl https://cotlet.dev/api/v1/vagaro/book_appointment \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"client_id":"cl_48213","service_id":"svc_1172","provider_id":"emp_309","start":"2026-10-16T14:00:00-07:00","notes":"Booked by agent from a Connect request"}'
Every tool is a POST endpoint at /api/v1/vagaro/{tool}. Send its parameters as JSON, exactly as listed in the endpoints above.
You get plain JSON back, ready for your script. A failed call costs nothing.
Why Cotlet
Why use Cotlet for Vagaro? Hosted, safe and kept working.
Built for agents
One MCP server for every app you connect.
The same tools as a REST API for scripts and cron jobs.
Works with Claude Code, Codex and Cursor.
Your login stays yours
You sign in to Vagaro yourself. We keep only the session, encrypted with AES-256.
The model never sees a login.
No stored passwords, no CAPTCHA solving, no MFA bypass.
You stay in control
Pick read only, or read and write.
Anything that reaches other people waits for your OK, unless you switch it off per tool.
Revoke access in one click.
Kept working for you
We test every integration daily.
When Vagaro changes, the tool pauses until we fix it.
Failed calls cost nothing.
Alternatives
Is there a Vagaro MCP server on GitHub?
We found no open-source Vagaro MCP server on GitHub. What exists besides Cotlet is the official API, which you must request and which only reads, and webhooks that push events out to tools like Zapier or Make. Hosted scrapers read public listings, not your account.
Cotlet compared with a Official API
Official API
Cotlet
Setup
Send the access form, wait up to seven business days, then build an OAuth client and your own code
Request access, sign in to Vagaro once in your browser, add one MCP server or API key
Who can use it
Businesses on Vagaro Credit Card Processing, not in the free trial
Any Vagaro business login you can sign in with
Booking and rescheduling
Not possible: appointments are retrieve only
Book, reschedule and cancel; each one asks for your OK by default
Waitlist, Connect and reviews
Not in the API reference
Waitlist, Connect replies and review replies
When Vagaro changes
You update your code
Our team tests it daily and fixes it for you; failed calls are free
Your Vagaro session
API credentials you store and rotate
Encrypted in an EU vault, limited to the actions you allow, revoked in one click
Price
Set by Vagaro, check your account
Free 7-day trial with 5,000 credits, then credits per call
Which one fits you
Pick Cotlet if
you are not a developer, or you do not want to maintain a server
you need it to keep working when Vagaro changes, without checking it yourself
your agent or a script should run it on a schedule, also while your computer is off
Pick an open-source server if
you are comfortable installing, updating and fixing it yourself
you want the session to stay on your own computer
you only need it now and then, from one MCP client
For AI agents
Cotlet for Vagaro in plain text The facts on this page in one block: status, endpoints, access, pricing, contact.
Endpoint health
verified 2h ago
list_locationspassing
list_servicespassing
list_appointmentspassing
search_availabilitypassing
find_clientpassing
+ 10 more endpoints
15/15 passing latest checkself-healing
vagaro.txt
Vagaro has an official public API, but it is limited and off by default (checked 11 Oct 2026). You request access with a form, Vagaro says activation can take up to seven business days, and it is only for businesses that use Vagaro Credit Card Processing and are not on the free trial. The reference covers locations, employees, customers and appointments, and appointments can only be retrieved: no booking, rescheduling, cancelling, waitlist, Connect messages or review replies.
Cotlet provides a hosted MCP server and REST API for Vagaro: 15 tools (8 read, 7 write).
Access Request access at https://cotlet.dev/app/signup?app=vagaro; we email the API key.
MCP server https://cotlet.dev/mcp/v1
REST base https://cotlet.dev/api/v1/vagaro
Auth Authorization: Bearer <COTLET_API_KEY>. Listing endpoints and schemas needs no key; calling an endpoint needs one.
Tools list_locations, list_services, list_appointments, search_availability, find_client, list_waitlist, list_conversations, list_reviews, book_appointment, reschedule_appointment, cancel_appointment, add_to_waitlist, notify_waitlist, reply_to_client, reply_to_review
Confirm book_appointment, reschedule_appointment, cancel_appointment, add_to_waitlist, notify_waitlist, reply_to_client, reply_to_review (by default the user approves each call; the user can switch this off per tool, e.g. for scheduled automations)
Markdown https://cotlet.dev/integrations/vagaro-api-mcp-server.md
How access works:
1. The user requests access at https://cotlet.dev/app/signup?app=vagaro (Vagaro is pre-selected). Each request is reviewed and the API key is sent by email.
2. The user signs in to Vagaro once in a browser. An agent cannot do this step.
3. The API key goes into the MCP client or the REST call as a bearer token.
Fits: people who want a hosted Vagaro server that someone else maintains, including non-developers.
Policy: Cotlet never stores passwords, never solves CAPTCHAs, never bypasses MFA.
Company: legal details in the Terms of service at https://cotlet.dev/terms. Contact contact@cotlet.dev.
Session: the user signs in to Vagaro in a browser; Cotlet keeps only the session, AES-256 encrypted, revocable in the dashboard at any time.
Terms: the user stays responsible for following Vagaro's terms; Cotlet is not affiliated with Vagaro.
Can Vagaro automations run on a schedule in n8n, Make or Zapier?
Yes. Cotlet does not replace your automation platform: it gives it a Vagaro connection it does not have, with the same API key as your agent. Write actions ask for your OK by default; switch that off in your dashboard for the tools you choose, for example to daily schedule and gap summary, and the schedule runs on its own. Cotlet runs in the cloud, so it keeps going while your computer is off.
Where to run Vagaro automations through Cotlet, and how to schedule them
Where
How to connect
How to schedule
Your AI agent
Add https://cotlet.dev/mcp/v1 with your API key.
A scheduled agent run, for example a Claude Code routine.
n8n
MCP Client node with https://cotlet.dev/mcp/v1, or an HTTP Request node to https://cotlet.dev/api/v1/vagaro/{tool}.
Schedule Trigger node.
Make
HTTP module: POST https://cotlet.dev/api/v1/vagaro/{tool} with an Authorization: Bearer header and a JSON body.
Scenario schedule.
Zapier
Webhooks by Zapier: POST https://cotlet.dev/api/v1/vagaro/{tool} with the same header and body.
Schedule by Zapier trigger.
Your own script
POST https://cotlet.dev/api/v1/vagaro/{tool} with your API key.
cron or GitHub Actions.
Pricing & limits
How much does the Vagaro API cost?
Free 7-day trial with 5,000 credits, no card needed. After that, the Vagaro API comes with the Cotlet plan, from $29 a month for 3,000 credits, with no limit on apps. Each month's credits stay valid for 3 months, so unused credits add up.
Cotlet plan sizes: price, monthly credits and price per credit
Size
Price
Credits / month
Per credit
Solo
$29/mo
3,000
about $0.0097
Pro
$99/mo
12,000
about $0.0083
Agency
$299/mo
40,000
$0.0075
Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.
About Cotlet
How Cotlet holds your access
Cotlet hosts MCP servers and REST APIs for apps with no usable API. Your agent works in your own Vagaro account.
Company details
The legal name, address and registration numbers of the company behind Cotlet are in the Terms of service. Terms
Your session
You sign in to Vagaro yourself, in your browser. We keep only the session, never your password: encrypted with AES-256 in an EU vault, isolated to your account and used only when your agent calls a Vagaro tool you allowed. When it expires, your agent gives you a link to sign in again. Security
Revoking access
Disconnect Vagaro in your dashboard: the session is deleted and access ends at once. Actions that reach other people wait for your OK unless you switch that off per tool.
What we never do
Store passwords, solve CAPTCHAs or bypass MFA.
Vagaro's terms
You use your own Vagaro account and stay responsible for following Vagaro's terms. Cotlet is independent and not affiliated with Vagaro. Terms
Request access and pick Vagaro. Cotlet reviews each request and emails you your API key.
Do I need to be technical?
No. You sign in to Vagaro once in your browser and paste one command into your agent, or one URL into n8n. Your agent can walk you through it. There is no server to install, update or fix.
Is a hosted server safe? My Vagaro session would leave my computer.
Cotlet keeps your Vagaro session encrypted with AES-256 in an EU vault, isolated to your account and used only for the tools you allow: read only, or read and write. The AI model never sees it, and you revoke it in one click. A local server keeps the same session in a file on your computer, readable by any program you run, and needs a fresh sign-in whenever it expires.
Do I need Vagaro API access to use Cotlet?
No. Cotlet works in your own Vagaro business login and does not use the official API. Vagaro's API needs a request form, up to seven business days, Credit Card Processing and a business that is not in the free trial (checked 11 Oct 2026).
Can my agent message clients without a messaging plan?
Only in chats clients start. Vagaro says that once the client closes the chat, you need a messaging plan to keep replying, so reply_to_client can fail on closed chats without one.
Can my agent post or send messages in Vagaro without asking me?
No. Every call to book_appointment, reschedule_appointment, cancel_appointment, add_to_waitlist, notify_waitlist, reply_to_client or reply_to_review waits for your OK by default. For scheduled automations you can switch confirmation off per tool in your dashboard, for example only for approvals.
Can I use the Vagaro API in n8n?
Yes. Add https://cotlet.dev/mcp/v1 with your API key in n8n's MCP Client node, or call https://cotlet.dev/api/v1/vagaro/{tool} from the HTTP Request node.
