Zenoti MCP Server
The Zenoti MCP Server enables AI agents to manage the full lifecycle of spa/wellness operations via the Zenoti API, covering:
Appointment Management: List, retrieve, check in guests, mark as no-show, and update appointment progress/status (confirmed, cancelled, no-show).
Service Booking: Discover available services, therapists, and centers; check available time slots; reserve and confirm bookings.
Guest Management: Search by email/phone/name/ID, create new profiles, retrieve details, and update existing records.
Invoice & Payment Processing: Retrieve invoice details, confirm invoices, and close them with payment (Cash, Card, Check, or Custom).
Forms & Feedback: List and retrieve appointment-related forms, and submit guest feedback including NPS scores and comments.
Center Management: List all centers in the organization.
Webhooks: Subscribe to real-time events such as invoice closures, guest profile changes, and appointment status updates.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Zenoti MCP Server Book a deep tissue massage for John Doe tomorrow at 3pm"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Zenoti MCP Server
A Model Context Protocol (MCP) server for the Zenoti spa/wellness/medspa management platform. Exposes appointments, guests, service booking, invoices, catalog, and forms as tools an AI agent can call.
Hosted version available
Do not want to manage credentials, hosting, and updates yourself? DOCK is the managed version of this server: encrypted per-practice auth, audit logs, draft-first write actions, and a workflow library. Founding practices lock lifetime pricing: Front Desk $49/mo (Zenoti), Billing Desk $99/mo (Tebra, BAA included), Full Practice $129/mo (both). https://dockhq.vercel.app
Installation
npm install -g zenoti-mcp-serverOr run from source:
git clone https://github.com/tacit-code/zenoti-mcp-server.git
cd zenoti-mcp-server
npm install
npm run buildRelated MCP server: vitta-mcp
Configuration
Variable | Required | Description |
| yes | API key from Zenoti Admin → Settings → Apps (create a backend app) |
| no | Base URL, default |
| recommended | Default center GUID; tools accept |
Claude Desktop / Claude Code config:
{
"mcpServers": {
"zenoti": {
"command": "npx",
"args": ["-y", "zenoti-mcp-server"],
"env": {
"ZENOTI_API_KEY": "your_api_key",
"ZENOTI_CENTER_ID": "your_center_guid"
}
}
}
}The server starts even without credentials and returns a readable configuration error on each tool call, so a misconfigured client shows the problem instead of crash-looping.
Tools
Catalog
Tool | Purpose |
| List organization centers (find center GUIDs) |
| Services of a center (compact by default, |
| Full service details |
| Therapists of a center, optionally filtered to a service |
| Who is on shift for a date range (date-scoped staffing) |
Guests
Tool | Purpose |
| Search by name/email/phone/code/tags (≥1 criterion required) |
| Create a guest profile |
| Guest details by GUID |
| Update fields — does a safe read-merge-write (Zenoti replaces the whole object on update) |
| Appointment history for a guest |
| Guest notes and profile alerts |
| Guest's memberships (status, credits, dues) |
| Guest's packages/series with remaining redemptions |
Appointments
Tool | Purpose |
| Center appointments for a date range (compact by default) |
| Appointment details ( |
| Check-in state ( |
| Mark no-show ( |
| Start/open/complete service ( |
| Cancel a booking (by |
| Start a reschedule (creates a booking draft tied to the invoice) |
Booking flow
zenoti-availability-slots— creates a booking draft for guest+service+date and returnsbooking_idplus open slotszenoti-booking-reserve— hold a chosen slot (holds are short-lived)zenoti-booking-confirm— finalize; the response includes the invoice
Invoices
Tool | Purpose |
| Invoice with line items, payments, and optional dues/fees |
| Record a cash/custom payment (financial action) |
| Charge the guest's card on file (financial action) |
| Close a fully-paid invoice |
| Email the receipt/invoice to the guest |
| Confirm (or undo-confirm) the visit — a scheduling status, despite living on the invoice |
Reports
Tool | Purpose |
| What was sold over a date range |
| Money received over a date range |
Forms & feedback
Tool | Purpose |
| Forms and submitted form data of an appointment |
| Forms on a guest profile |
| Insert externally collected guest feedback |
Zenoti API gotchas this server handles
Three identifiers in one workflow. Check-in/no-show/feedback take
appointment_group_id; details/progress/forms takeappointment_id; cancel and payments takeinvoice_id. Tool schemas name the exact one required.Guest updates replace the whole object. The update tool fetches the current profile and merges your changes; a naive partial
PUTwould erase fields.Rate limit is 60 calls/minute (org-wide). The HTTP layer honors
Retry-Afteron 429. Reads also retry on 5xx/network failures/timeouts; writes retry only on 429 (a rate-limit rejection was never processed, so retrying can't duplicate a booking — any other write failure surfaces immediately).Pagination caps at
size=100; larger values are rejected by Zenoti with a 422.Webhooks have no subscription API — they are configured in the Zenoti web UI (Admin → Webhooks) and require the Zenoti API package. This server intentionally has no webhook tool.
Undocumented numeric enums. Gender and appointment-progress codes aren't in Zenoti's public docs; the mappings used here are documented in the tool descriptions and can be overridden (
progress_code).
Development
npm run dev # run from source (tsx)
npm test # unit + end-to-end tests (mock Zenoti API; no real credentials needed)
npm run typecheck # tsc --noEmit
npm run build # emit dist/The e2e suite spawns the real server over stdio via the MCP SDK client and asserts every tool's method, path, query, and body against Zenoti's documented endpoints.
License
MIT
Available Tools
23 toolszenoti-appointments-checkinD
Check in an appointment
Inputs: appointment_id (required).
zenoti-appointments-getB
Get detailed appointment information
Inputs: appointment_id (required).
zenoti-appointments-listC
List appointments for a center with filtering options
Inputs: center_id (required), date (required), status, guest_id, +3 more.
zenoti-appointments-noshowC
Mark appointment as no-show
Inputs: appointment_id (required).
zenoti-appointments-progressC
Update appointment progress status
Inputs: appointment_id (required), status (required), service_id.
zenoti-availability-slotsD
Get available slots
Inputs: center_id (required), date (required), service_id (required), therapist_id.
zenoti-booking-confirmD
Confirm booking
Inputs: reservation_id (required), notes.
zenoti-booking-reserveD
Reserve a slot
Inputs: center_id (required), slot_time (required), service_id (required), therapist_id (required), +1 more.
zenoti-centers-listD
List centers
Inputs: page, size.
zenoti-feedback-submitD
Submit feedback
Inputs: appointment_id (required), rating (required), feedback (required), nps_score.
zenoti-forms-getD
Get form data
Inputs: form_id (required).
zenoti-forms-listC
List forms for an appointment
Inputs: appointment_id (required).
zenoti-guests-createC
Create a new guest
Inputs: center_id (required), first_name (required), last_name (required), mobile_country_code, +3 more.
zenoti-guests-getC
Get guest details
Inputs: guest_id (required).
zenoti-guests-searchC
Search for guests
Inputs: center_id (required), search_type (required), search_value (required), page, +1 more.
zenoti-guests-updateC
Update guest information
Inputs: guest_id (required), first_name, last_name, email, +3 more.
zenoti-invoices-closeC
Close invoice with payment
Inputs: invoice_id (required), payment_amount (required), payment_type (required), payment_notes.
zenoti-invoices-confirmC
Confirm an invoice
Inputs: invoice_id (required).
zenoti-invoices-getC
Get invoice details
Inputs: invoice_id (required).
zenoti-services-getD
Get service details
Inputs: service_id (required), center_id (required).
zenoti-services-listC
List services
Inputs: center_id (required), category_id.
zenoti-therapists-listD
List therapists
Inputs: center_id (required), service_id, date.
zenoti-webhooks-subscribeC
Subscribe to webhooks
Inputs: event_type (required), callback_url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Each tool targets a distinct resource-action combination (e.g., checkin, list, noshow, progress for appointments; reserve/confirm for booking; CRUD for guests). There is no overlap or ambiguity between tools.
All tools follow a consistent pattern of 'zenoti-<resource>-<action>', making it easy to predict functionality. The naming is clean and uniform across all 23 tools.
23 tools cover a wide range of salon/spa management functions without being excessive. The count is well-balanced for the domain, providing comprehensive functionality.
The tool set covers most core workflows (appointments, booking, guests, invoices, services, therapists, webhooks). Minor gaps exist, such as no explicit create appointment or delete operations, but the booking workflow implicitly creates appointments and the surface is largely complete.
Maintenance
Related MCP Connectors
Manage an EasyWeek business from AI: bookings, availability, customers, services, orders, messaging.
Manage Bookla bookings, availability, services, resources and clients with AI agents.
Schedule, members, and bookings in your AI tools
Read AgendaPro bookings, slots, clients, services and sales; create, update and cancel bookings.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to automate Epiphany booking tasks, including checking availability and creating bookings.7MIT
- AlicenseAqualityCmaintenanceEnables AI agents to look up businesses, find free appointment slots, book, list and cancel appointments at salons, barbershops, nail and brow studios and clinics. Works read-only without a customer login by returning a pre-filled booking link, and can also run against a built-in demo with sample businesses.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to read agents, teams, appointment types, bookable resources, and scheduling requests from the TimeZest API, and to create a scheduling request when explicitly requested, optionally linked to a PSA ticket. This supports appointment-booking workflows where MSP customers book time with technicians from PSA tickets.Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to manage appointments, reschedule bookings, look up clients, and add client notes in a user's signed-in business account without requiring an API key.7Elastic 2.0