How to Use the Acuity Scheduling MCP in Windsurf

Q: Does Windsurf read my Acuity Scheduling appointment details?

Yes, Cascade calls the getappointment tool to pull full details using a specific ID. It sees the exact same data you view in the admin dashboard.

Let Windsurf Cascade manage your booking logic directly from your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Acuity Scheduling MCP to Windsurf

Create your Vinkius account to connect Acuity Scheduling to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Acuity Scheduling with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf MCP Server for Bookings

The `list_appointment_types` and `check_availability_dates` tools give Cascade direct access to your schedule. You ask for an open slot, and the agent reads your active services, finds the required ID, and checks the calendar without waiting for your approval. Once it finds those open dates, Cascade immediately calls `list_available_times` to pinpoint exact booking windows. You build a scheduling widget frontend while Windsurf tests the real booking data in the background.

Pull Real Calendar Data

Calling `list_calendars` exposes every provider and instructor in your business profile. Cascade uses this to map specific team members to the UI components you are actively building. It grabs that context and immediately pulls their booked sessions using `list_appointments`. Your agent formats the date ranges, fetches the records, and injects realistic state into your mockups before you even touch the keyboard.

Handle Group Classes and Sales

The `list_classes` tool tells Windsurf exactly how many people are enrolled versus total capacity for group sessions. Group classes require entirely different logic than one-on-one meetings, and your agent needs this data to build accurate interfaces. If your client also sells gift certificates, this MCP server hits `list_products` to pull pricing data. You tell the agent to build a checkout flow, and it wires up the exact items available in your connected account.

Setup guide

Set up Acuity Scheduling MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Acuity Scheduling MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Acuity Scheduling payment history." If connected, Cascade will call the Acuity Scheduling tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "acuity-scheduling-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Acuity Scheduling now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Acuity Scheduling MCP in Windsurf

Open your MCP panel and click the Marketplace tab for a one-click install. You can also manually add the endpoint to your ~/.codeium/windsurf/mcp_config.json file under the servers array.

Yes, Cascade calls the get_appointment tool to pull full details using a specific ID. It sees the exact same data you view in the admin dashboard.

You want to build booking interfaces without constantly switching tabs to check API responses. Cascade handles the multi-step fetching automatically so you stay focused on writing code.

The system handles multiple instructors easily. Your agent calls the calendar list tool first, grabs the provider IDs, and maps the availability for each one.

This connection exposes client names, booking dates, and class capacities to your editor. Vinkius isolates this traffic within a V8 sandbox, destroying the environment immediately after the agent finishes pulling the schedule.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript