Acuity Scheduling MCP. Manage bookings and check real-time availability in conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Acuity Scheduling manages appointments, calendars, classes, and client products for service businesses using natural conversation. It lets your agent instantly check real-time availability across multiple staff members or retrieve full records of past bookings with minimal input.
What your AI agents can do
Check availability dates
Confirms which dates have open booking slots for a specific service type.
Get account
Retrieves basic operational details and settings from your connected business account.
Get appointment
Gets the full record for a single appointment using its unique ID number.
The system determines if a specific service is available on certain dates and times.
You can pull up the full details for any past or scheduled appointment, including client notes and intake form answers.
It retrieves a current list of all bookable services, their prices, durations, and available gift certificates.
You get a roster of all providers or instructors and can check their individual working calendars.
It reports on group sessions, showing how many spots are open versus the total capacity.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Acuity Scheduling with 9 Tools
These nine tools let you access every facet of your booking system: from checking a single client's appointment history to listing all available staff and services.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Acuity Scheduling on Vinkius019d7546check availability dates
Confirms which dates have open booking slots for a specific service type.
019d7546get account
Retrieves basic operational details and settings from your connected business account.
019d7546get appointment
Gets the full record for a single appointment using its unique ID number.
019d7546list appointment types
Shows all active services offered, including their price and how long they last.
019d7546list appointments
Pulls a list of booked appointments within a specific date range you define.
019d7546list available times
Lists the exact, available time slots for a service on a particular day.
019d7546list calendars
Retrieves a list of all staff members and instructors who are set up in your system.
019d7546list classes
Reports on scheduled group classes, including how many people are currently enrolled.
019d7546list products
Retrieves the details for gift certificates or physical items you sell through Acuity.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Acuity Scheduling, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Acuity Scheduling. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 9 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The manual calendar audit takes forever.
Right now, figuring out who's free when is a mess of clicking through different tabs: checking the main staff calendar, jumping to the group class roster, and then cross-referencing individual notes for client intake form answers. You end up emailing five people just to confirm one open slot.
With this MCP, you tell your agent exactly what you need—like 'Find me a 60-minute spot with Jake next week.' The system runs all the checks internally and gives you back only the confirmed slots; no more clicking through multiple screens or juggling five different browser tabs.
list_available_times: Instant Slot Confirmation
You no longer have to manually check a staff member's schedule, then look up the service duration, and finally verify if that time slot conflicts with another booking. The system runs those three checks automatically.
It gives you one clean list of usable times. That’s it.
What you can do with this MCP connector
Managing a booking business is already complicated enough without adding calendar chaos. This MCP connects your Acuity Scheduling account to your AI agent, letting you handle every aspect of client scheduling through conversation alone. You can ask the system what times are open for a specific service or find out which instructors are available next month.
It pulls not just dates, but detailed booking records and even product inventory. Because sensitive schedules are involved, we built this MCP to run on Vinkius's zero-trust proxy. This means your account credentials pass through the system for action but never sit on a disk; they're only used in transit.
You can use this single connection from any compatible client—Claude, Cursor, or Windsurf—to manage everything without worrying about where your keys are stored.
019d7546-3bd8-72b0-8613-f9a1e6688fc6 
How Acuity Scheduling MCP Works
- 1 Connect your Acuity Scheduling account once through Vinkius. This establishes access to all booking data and credentials.
- 2 Tell your agent what you need—for instance, 'Check availability for Private Yoga next Tuesday.'
- 3 The MCP processes the request against live data sources and returns structured information: a list of specific available times or appointment records.
The bottom line is that you stop clicking through tabs; your agent just talks to the booking system.
Who Is Acuity Scheduling MCP For?
This MCP is for small business owners who run physical services—boutiques, studios, or private practices. It's for the wellness coordinator tired of manually cross-referencing five different staff calendars to find a single open slot.
Uses this MCP to quickly check if multiple trainers have available 1-on-1 slots next week, then drafts the confirmation message for the client.
Checks group class capacities and finds specific dates when a popular instructor is free to teach an extra session.
Retrieves appointment details, including the client's submitted intake form answers, so they can prep for the next session without digging through emails.
What Changes When You Connect
- Stop guessing dates. Use
list_available_timesto get the precise open time slots for any service on a given day, eliminating back-and-forth emails. - Get full context immediately. Instead of searching through old records, use
get_appointmentto pull up all client details and intake form answers in one go. - Manage your whole catalog at once. Use
list_appointment_typesto see every service you offer—from 30-minute consultations to multi-hour workshops—with pricing and duration. - Keep tabs on staff time. The MCP can run
list_calendarsto give you a clear roster of all providers, letting you delegate scheduling tasks accurately. - See inventory at a glance. Use
list_productsif you need to confirm gift card balances or the latest stock count before confirming a bulk order. - Build complex automations by combining this MCP with others in the Vinkius catalog. You can chain it with, say, an email sending MCP to automatically send booking confirmations.
Real-World Use Cases
Client needs a last-minute slot.
A client asks: 'Do you have any openings for a deep tissue massage next Thursday?' The agent runs list_available_times and finds the exact 10:30 AM opening with Sarah, immediately giving the client a confirmed time.
Staffing shortage planning.
The manager needs to know which instructors are available next month. They use list_calendars and check_availability_dates to identify that three key staff members have overlapping gaps, allowing them to fill the schedule proactively.
Checking group class capacity.
A student asks if the advanced Pilates workshop has space. The agent runs list_classes, sees the current enrollment count against total capacity, and confirms there are still five spots open.
Processing a gift certificate claim.
The front desk staff needs to verify if a client's prepaid product is valid. They use list_products to check the current status of gift certificates and available merchandise before finalizing the booking.
The Tradeoffs
Trying to find all availability in one call
Asking, 'What's open next week?' without specifying service type or staff member. This is too vague for any tool.
→
Be specific. Instead of that, ask the agent: 'Run check_availability_dates for Private Yoga Session and filter results by Sarah.' Always specify the service and time frame.
Only checking if a date is open
Asking only, 'Are you open next Tuesday?' This tells you nothing about which specific times are free.
→
Always follow up with: 'And what are the available slots for that service on Tuesday?' You need list_available_times to get usable data.
Confusing bookings and services
Asking the agent to list all clients without specifying a date range. The system needs boundaries.
→
To see past appointments, you must specify when: 'Run list_appointments for October 1st through October 30th.' Always give the date parameters.
When It Fits, When It Doesn't
Use this MCP if your business relies on coordinating time slots across multiple people or services. You need a single source of truth for availability, class capacity, and booking history. Don't use it if you just need to view static information (like reading a simple price list); in that case, the service portal works fine. However, don't use this MCP if your primary pain point is managing billing or payment processing; those are dedicated financial tools. This MCP focuses purely on time and scheduling logistics across all services.
Common Questions About Acuity Scheduling MCP
How does `list_available_times` work? +
list_available_times finds every moment a specific service can be booked on a given date, giving you the precise time windows available for scheduling.
Can I use `list_appointments` to see last month's bookings? +
Yes. You must specify both a start and end date range when calling list_appointments. The tool will pull all records within that window for you.
What is the difference between `list_calendars` and `get_account`? +
list_calendars pulls a list of every person (provider/instructor) in your system. get_account retrieves overall business settings and profile data for the account itself.
Do I need to use `list_appointment_types` first? +
It's helpful, but not required. list_appointment_types lets you browse all services offered in your business, which helps you know what service ID to give the agent later.
When I use `get_account`, what information does it retrieve about my business? +
It retrieves your core business profile and general account settings. This initial call ensures your agent knows the proper context for all subsequent actions, whether you're checking availability or listing products.
Can I find a specific booking using only its ID with `get_appointment`? +
Yes, you must provide the unique appointment ID. This tool pulls every detail for that single session, including the service type and any answers provided on the client's intake form.
How does `list_classes` help me manage group capacity? +
It gives you a list of all scheduled group classes, showing both the total allowed capacity and how many spots are currently enrolled. This helps your agent prevent overbooking when planning large sessions.
If I need to check for open slots across multiple months, should I use `check_availability_dates`? +
Yep, that's the tool you want. You just supply the Appointment Type ID and the desired month. It tells your agent exactly which dates have openings for that specific service.
Which Acuity plan do I need? +
API access requires the Growing or Powerhouse plan. The free and Emerging plans do not include API access. You can check your plan in Settings → Subscription.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.