Skip to main content

Wix Bookings MCP Server

Create a powerful Model Context Protocol (MCP) server for Wix Bookings in minutes with our AI Gateway. This guide walks you through setting up seamless scheduling and appointment management integration with enterprise-grade security and instant OAuth authentication.

About Wix Bookings API​

Wix Bookings is a comprehensive scheduling and appointment management platform for service-based businesses. The Bookings API provides programmatic access to:

  • Service Catalog: Manage bookable services with pricing and duration
  • Staff Management: Create and manage staff members and resources
  • Booking Operations: Create, confirm, cancel, and reschedule appointments
  • Availability: Query available time slots for booking
  • Calendar Integration: View and manage calendar events
  • Customer Portal: Integration with online booking interfaces

Key Features​

  • Service Types: APPOINTMENT (one-on-one), CLASS (group sessions), COURSE (multi-session)
  • Resource Scheduling: Staff availability and resource allocation
  • Real-time Availability: Dynamic slot availability queries
  • Booking Workflows: Confirmation, cancellation, and rescheduling flows
  • Calendar Events: Unified view of bookings and blocked times
  • Payment Integration: In-person and online payment options
  • Custom Forms: Booking form customization
  • Multi-location: Support for multiple business locations

What You Can Do with Wix Bookings MCP Server​

The MCP server transforms Wix Bookings API into a natural language interface, enabling AI agents to:

Service Management​

  • Service Operations

    • "Create a new 30-minute haircut service priced at $45"
    • "List all available appointment services"
    • "Update the yoga class capacity to 20 participants"
    • "Hide the massage service from online booking"

  • Service Configuration

    • "Set up a 60-minute consultation with online booking enabled"
    • "Configure payment options for in-person services"
    • "Add multiple session durations to a service"
    • "Update service descriptions and taglines"

Staff & Resource Management​

  • Staff Operations

    • "Add a new staff member named Jane Smith"
    • "List all staff members and their assigned services"
    • "Update staff contact information"
    • "Assign staff to specific services"

  • Availability Configuration

    • "Check staff availability for next week"
    • "View blocked time periods for each staff member"
    • "Set up working hours for new employees"
    • "Manage resource scheduling conflicts"

Booking Management​

  • Appointment Booking

    • "Book a haircut for John Doe tomorrow at 2 PM"
    • "Create a class reservation for 5 participants"
    • "Schedule a consultation with a specific staff member"
    • "Book using an available session slot"

  • Booking Operations

    • "Confirm the pending booking for customer Jane"
    • "Cancel tomorrow's 3 PM appointment with notification"
    • "Reschedule the booking to next Friday at 10 AM"
    • "List all confirmed bookings for this week"

  • Booking Queries

    • "Show all upcoming bookings for today"
    • "Find bookings for a specific service"
    • "List pending bookings awaiting confirmation"
    • "Get booking details by customer email"

Calendar & Availability​

  • Availability Queries

    • "Find available slots for haircut service next week"
    • "Check availability for a specific staff member"
    • "Show open spots for yoga class on Saturday"
    • "Get bookable time slots for the next 7 days"

  • Calendar Management

    • "View all calendar events for this month"
    • "Show staff schedules and blocked times"
    • "List booking conflicts and overlaps"
    • "Generate weekly calendar report"

Reporting & Analytics​

  • Booking Analytics

    • "Count bookings by service type this month"
    • "Track cancellation rates by service"
    • "Analyze peak booking times"
    • "Report on staff utilization"

  • Customer Insights

    • "List repeat customers and their booking history"
    • "Track no-show rates by customer"
    • "Analyze booking patterns by day of week"
    • "Generate customer retention report"

Prerequisites​

  • Access to Cequence AI Gateway
  • Wix account with Bookings app installed
  • App development access in Wix
  • API credentials (Client ID and Secret)

Step 1: Create Wix App​

Before setting up the MCP server, you need to create an app in Wix.

1.1 Access Wix Developers​

  1. Navigate to dev.wix.com
  2. Sign in with your Wix account
  3. Go to My Apps in the developer dashboard

1.2 Create New App​

  1. Click Create New App
  2. Select Build from scratch
  3. Fill in app details:
    • App Name: "AI Gateway Bookings MCP"
    • Description: "MCP server for Wix Bookings automation"

1.3 Configure OAuth​

  1. Navigate to OAuth settings
  2. Add Redirect URL: 
    https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback
  3. Select required permissions for Bookings access

1.4 Get Credentials​

  1. Go to OAuth page
  2. Copy App ID
  3. Copy App Secret Key

Step 2: Access AI Gateway Apps​

  1. Log in to your Cequence AI Gateway dashboard
  2. Navigate to Apps in the left sidebar

Step 3: Find and Select Wix Bookings API​

  1. Browse the Third-party category
  2. Look for Wix Bookings
  3. Click on the API card to view details

Step 4: Create MCP Server​

Click Create MCP Server to start the wizard.

Step 5: Configure API Endpoints​

  1. Base URL: https://www.wixapis.com
  2. Select API endpoints to expose:
    • Services (create, query, get, update, delete)
    • Staff Members (create, query)
    • Bookings (create, query, get, confirm, cancel, reschedule)
    • Availability (query)
    • Calendar Events (query)
  3. Click Next

Step 6: MCP Server Basic Setup​

  1. MCP Server Name: "Wix Bookings Scheduler"
  2. Description: "Scheduling and appointment management for service businesses"
  3. Production Mode: Toggle as needed
  4. Click Next

Step 7: Configure Authentication​

  1. Authentication Type: OAuth 2.0

  2. Fill in OAuth settings:

    • Authorization URL: 
      https://www.wix.com/installer/install
    • Token URL: 
      https://www.wixapis.com/oauth2/token
    • Client ID: Paste from Wix app
    • Client Secret: Paste from Wix app
    • Redirect URI: 
      https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback

  3. Required Headers:

    • Authorization: Bearer {access_token}
    • wix-site-id: {site_id}

Step 8: Configure Security​

  1. API Protection: Toggle ON to enable

    • Protects against bot attacks, DDoS, and threats
    • Monitors for suspicious activity
    • Rate limiting and anomaly detection

  2. Click Next

Step 9: Choose Deployment Method​

  • Fully managed deployment
  • Automatic scaling and monitoring
  • Built-in high availability

Option B: Deploy with Helm Chart​

  • Self-managed Kubernetes deployment
  • Full control over infrastructure

Click Next after selecting.

Step 10: Review and Deploy​

Review your configuration:

  • MCP Server Name: Your chosen name
  • Base URL: https://www.wixapis.com
  • Selected Endpoints: Bookings operations
  • Authentication: OAuth 2.0 (Configured)
  • API Protection: Enabled/Disabled

Click Create & Deploy to finalize.

Using Your Wix Bookings MCP Server​

Setup Instructions:

Common Use Cases​

Appointment Scheduling​

  • Online booking systems
  • Customer self-service portals
  • Staff calendar management
  • Automated confirmation emails

Class & Course Management​

  • Group class bookings
  • Capacity management
  • Waitlist handling
  • Multi-session course enrollment

Staff Scheduling​

  • Resource allocation
  • Availability management
  • Work schedule optimization
  • Conflict detection

Business Operations​

  • Booking analytics and reporting
  • Revenue tracking by service
  • Customer engagement metrics
  • Operational efficiency analysis

Security Best Practices​

  1. OAuth Security:

    • Secure credential storage
    • Regular token rotation
    • Minimal permission scopes
    • Monitor API usage

  2. Data Protection:

    • Customer data privacy
    • GDPR compliance
    • Secure transmission
    • Audit logging

  3. Access Control:

    • Role-based permissions
    • Staff-level access limits
    • Site-specific tokens
    • Session management

Troubleshooting​

Common Issues​

  1. 401 Unauthorized

    • Verify access token validity
    • Check wix-site-id header
    • Ensure app is installed on site
    • Regenerate credentials if expired

  2. 404 Not Found

    • Verify resource IDs exist
    • Use query endpoints for lookups
    • Check collection/service exists
    • Confirm booking ID format

  3. 400 Bad Request

    • Check required fields (staffMemberIds, sessionDurations)
    • Verify payment.options configuration
    • Validate date/time formats (ISO 8601)
    • Ensure locationType is set

  4. 409 Conflict

    • Check revision number for updates
    • Verify slot availability
    • Handle concurrent booking conflicts
    • Refresh and retry operation

Getting Help​