Zenoti MCP Server

A Model Context Protocol (MCP) server that provides intelligent access to the Zenoti spa/wellness management API. Designed for AI agents to efficiently manage appointments, guests, services, and billing workflows.

Features

Workflow-Centric Tools

• Complete Service Booking: Single tool handles the entire 4-step booking flow
• Guest Lifecycle Management: Create, search, update guests with smart defaults
• Appointment Management: Check-in, status updates, and progress tracking
• Invoice & Payment: Retrieve, confirm, and close invoices with proper error handling
• Forms & Feedback: List forms, retrieve data, and submit feedback

Agent-Optimized Design

• Context-Efficient Responses: Returns only essential information by default
• Smart Error Messages: Guides agents toward correct usage patterns
• Workflow Consolidation: Combines related operations into single tools
• Human-Readable Outputs: Uses names over IDs, dates in readable format

Installation

1. Clone the repository:

git clone https://github.com/yourusername/zenoti-mcp-server.git
cd zenoti-mcp-server

2. Install dependencies:

npm install

3. Configure environment variables:

cp .env.example .env
# Edit .env with your Zenoti API credentials

4. Build the server:

npm run build

Configuration

Environment Variables

• ZENOTI_API_KEY: Your Zenoti API key (required)
• ZENOTI_API_URL: Zenoti API base URL (default: https://api.zenoti.com)
• ZENOTI_CENTER_ID: Default center ID for operations
• ZENOTI_ORG_ID: Your organization ID

Obtaining API Credentials

1. Log into Zenoti Admin
2. Navigate to: Admin > Setup > Apps (organization level)
3. Create a new backend app
4. Assign necessary module permissions (avoid global permissions)
5. Copy the API key (valid for 1 year)

Usage

Running the Server

# Development mode with auto-reload
npm run dev

# Production mode
npm start

# Test the server with example client
npm test

Connecting from Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "zenoti": {
      "command": "node",
      "args": ["/path/to/zenoti-mcp-server/dist/index.js"],
      "env": {
        "ZENOTI_API_KEY": "your_api_key",
        "ZENOTI_API_URL": "https://api.zenoti.com",
        "ZENOTI_CENTER_ID": "your_center_id"
      }
    }
  }
}

Available Tools

Service Booking

book_service

Complete 4-step service booking workflow in a single tool.

Parameters:

• guest_id (required): Guest ID or search query
• service_id (required): Service ID or name
• date (required): Appointment date (YYYY-MM-DD)
• time (optional): Preferred time (HH:MM)
• therapist_id (optional): Therapist ID or name
• notes (optional): Booking notes
• pay_later (optional): Skip payment (default: true)

Example:

{
  "guest_id": "john.doe@email.com",
  "service_id": "Deep Tissue Massage",
  "date": "2025-11-15",
  "time": "14:00"
}

Guest Management

search_guests

Search for guests by name, email, or phone.

Parameters:

• query (required): Search query
• limit (optional): Max results (default: 10)

create_guest

Create a new guest profile.

Parameters:

• first_name (required)
• last_name (required)
• email (optional)
• phone (optional)
• gender (optional)
• date_of_birth (optional)

Appointment Management

list_appointments

List appointments with filters.

Parameters:

• start_date (required): Start date (YYYY-MM-DD)
• end_date (optional): End date (default: start_date)
• status (optional): Filter by status
• guest_id (optional): Filter by guest
• limit (optional): Max results (default: 50)

check_in_appointment

Check in a guest for their appointment.

Parameters:

• appointment_id (required): Appointment or group ID

update_appointment_status

... View full README on GitHub