# Acuity Scheduling MCP MCP > Acuity Scheduling MCP manages client appointments, availability, and services through natural conversation. It lets your AI agent pull real-time data on open slots, list all available service types, view group class capacity, or retrieve specific booked session details without you lifting a finger. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** appointment-booking, intake-forms, availability-management, client-scheduling, service-management, calendar-sync ## Description Need to manage bookings for a studio, clinic, or personal training business? This MCP connects your Acuity Scheduling account directly to your AI agent. Instead of logging into the platform and clicking through pages, you just ask your AI client what you need. Your agent uses these tools to pull specific detailsβ€”like checking if there are any open private yoga slots tomorrow, or listing all gift certificates available for sale. It handles everything from viewing a full roster of providers' schedules to managing group class enrollment counts. When you connect this through Vinkius, your AI client gets one place to access hundreds of services, making scheduling data accessible whether you use Claude, Cursor, or any other MCP-compatible tool. You stop fighting with tabs and dropdown menus; you just talk to it. ## Tools ### check_availability_dates Checks which dates have open booking slots for a specific service type. ### get_account Retrieves the business profile and general account settings from your Acuity account. ### get_appointment Pulls all details for one specific appointment using its unique ID number. ### list_appointment_types Lists every active, bookable service your business offers, along with pricing and length. ### list_appointments Retrieves a list of all booked appointments within a specific date range you provide. ### list_available_times Lists the exact time slots when someone can book a given service on a specified date. ### list_calendars Retrieves all calendars, helping you identify every provider or instructor in your system. ### list_classes Gets a list of group classes scheduled, including their current enrollment and maximum capacity. ### list_products Retrieves details about gift certificates or physical products available for purchase through Acuity. ## Prompt Examples **Prompt:** ``` Do I have any open slots for private yoga tomorrow? ``` **Response:** ``` Available slots for **Private Yoga Session** tomorrow: πŸ“… **8:00 AM** β€” Sarah's calendar βœ… πŸ“… **10:30 AM** β€” Sarah's calendar βœ… πŸ“… **2:00 PM** β€” Jake's calendar βœ… πŸ“… **4:30 PM** β€” Sarah's calendar βœ… πŸ“… **6:00 PM** β€” Jake's calendar βœ… 5 slots available across 2 instructors. The 2:00 PM with Jake is the prime afternoon slot β€” shall I help you draft a booking confirmation message? ``` ## Capabilities ### Find Open Appointment Slots Check which dates and times are free for a specific service across multiple providers. ### Review Client History Pull up the full details of any specific booked session using its unique ID. ### List All Services Offered Retrieve a complete list of all bookable services, including their prices and durations. ### Check Instructor Availability Get a full roster listing every instructor or provider and their current schedule blocks. ### Manage Group Classes View group class schedules, including how many spots are filled versus the total capacity. ### Access Account Details Retrieve core business profile and account settings for verification or reference. ## Use Cases ### A Client Asks, 'Are you available next week?' The agent calls `list_appointment_types` first. Then it uses `check_availability_dates` to narrow down the options for Private Yoga Session on Tuesday. It returns three specific time slots and which instructor is free for that slot. ### A Staff Member Needs a Report of All Bookings Instead of filtering by date range in the system, they ask their agent to run `list_appointments` for last month. The agent delivers a clean list showing client names and service types. ### Checking if a Specific Instructor is Free A manager asks about Sarah's schedule. The agent runs `list_calendars`, finds Sarah’s calendar, and then uses `list_available_times` to confirm all her open slots for the week. ### Upselling Products During a Consultation While discussing services, they ask about retail items. The agent runs `list_products`, showing available gift certificates or products that can be immediately purchased by the client. ## Benefits - Stop checking tabs. You can list all bookable services using `list_appointment_types` and instantly know what pricing or duration to quote a client, without needing to navigate the service portal. - Never lose track of capacity again. Use `list_classes` to see group class enrollment counts versus total spots, helping you sell out classes faster. - Instantly check open slots for any session type with `check_availability_dates`. You just need to provide the date and service name; the system handles the rest. - Need historical data? With `list_appointments`, your agent pulls all booked sessions in a range, giving you an overview without opening individual records. - Get full visibility into who's working. The MCP lets you run `list_calendars` to get every provider and their specific schedule, even if they aren't currently booked. - You can check for precise open times using `list_available_times`, which is the most accurate way to help a client book an exact slot. ## How It Works The bottom line is that your AI client turns complex calendar data into simple, conversational answers. 1. Start by asking your agent to list all bookable services, which gives a scope of what's available (like pricing or session type). 2. Next, ask the agent to check availability dates and times for a specific service on a given date. 3. The agent sends you back the confirmed time slots, allowing you to proceed with viewing an appointment or confirming booking details. ## Frequently Asked Questions **How do I check if an instructor is available using the list_calendars tool?** You first run `list_calendars` to get all providers' names. Then, you specify which provider and what date range you need when asking for a time slot. **If I want to know about gift certificates, should I use list_products?** Yes, `list_products` retrieves details on any products or gift cards available through your account. It’s perfect for quickly checking inventory value during a call. **What is the difference between list_appointments and get_appointment?** `list_appointments` gives you a batch of records, filterable by date range. `get_appointment` requires a single unique ID to pull all details for one specific booking. **How do I find out what services my business offers?** Run `list_appointment_types`. It shows every active service, along with its price and how long the session lasts. This is your starting point for any query. **How do I use list_available_times to check for specific open booking slots?** The tool lists exact times when someone can book the service. It provides a precise schedule, letting you know exactly which time blocks are free on a given date. **What information does list_classes provide about group sessions?** This tool retrieves group classes, including their scheduled capacity and current enrollment counts. You can quickly see how many spots are left in a class. **How do I use get_account to check my business's main settings?** It pulls your entire business profile and account setup details from Acuity. This is useful for verifying general operational parameters or checking the primary account status. **What detailed client information can I retrieve using get_appointment?** You can pull the full record of a specific appointment, including not just the booking details but also any answers provided on the client's intake form.