How to Use the Acuity Scheduling Alternative MCP in Windsurf

Q: How does Windsurf use the Acuity Scheduling Alternative to resolve booking conflicts?

Cascade reads your schedule using listappointments and matches it against your code deadlines. It then automatically runs rescheduleappointment to move conflicting meetings to open slots using this MCP integration.

Q: Can I bulk-schedule client sessions using Windsurf and this Acuity Scheduling Alternative?

Yes, Cascade chains getavailability and createappointment to book multiple slots in one go. You feed it a list of times, and it runs the sequence autonomously in your editor.

Q: How do I configure this Acuity Scheduling Alternative in my Windsurf workspace?

Add the server URL to your mcpconfig.json file under the mcpServers key. Cascade immediately auto-discovers the booking tools on this MCP Server and starts using them during your chat sessions.

Q: What happens if Cascade tries to book a slot that is already taken?

The getavailability tool checks real-time calendar slots first. If a conflict occurs during execution, Cascade stops, reads the error, and picks the next open slot.

Let Cascade autonomously manage bookings and audit calendar availability directly inside Windsurf.

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 Alternative MCP to Windsurf

Create your Vinkius account to connect Acuity Scheduling Alternative 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 Alternative with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Calendar Auditing with Cascade

The `list_appointments` tool lets Windsurf pull your entire schedule to find conflicts without you lifting a finger. Cascade reads your active files, notices you have a deadline, and automatically checks your calendar to see if you are free. When conflicts pop up, this MCP Server runs `reschedule_appointment` to move things around. You just watch the output log as your calendar reorganizes itself.

Multi-Step Booking Workflows via Windsurf MCP Server

The `create_appointment` tool lets Cascade book new sessions directly from your chat context. If a client emails you requesting a specific slot, Cascade matches it against `list_calendars` to ensure no double-bookings occur. It doesn't stop at creation. Cascade immediately chains `list_appointment_types` to categorize the slot, then uses `get_me` to verify your account details before writing the final confirmation to your workspace.

Automated Appointment Cleanups

The `cancel_appointment` tool removes canceled sessions from your workspace files and calendar simultaneously. When Cascade detects a cancellation email in your workspace context, it initiates the cleanup sequence without prompting you for every step. It calls `list_categories` to identify the meeting type, checks details using `get_appointment`, and wipes it clean. Your local files and external scheduler stay perfectly in sync.

Setup guide

Set up Acuity Scheduling Alternative 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 Alternative 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 Alternative payment history." If connected, Cascade will call the Acuity Scheduling Alternative tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "acuity-scheduling-alternative-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 Alternative 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 Alternative MCP in Windsurf

Cascade reads your schedule using `list_appointments` and matches it against your code deadlines. It then automatically runs `reschedule_appointment` to move conflicting meetings to open slots using this MCP integration.

Yes, Cascade chains `get_availability` and `create_appointment` to book multiple slots in one go. You feed it a list of times, and it runs the sequence autonomously in your editor.

Add the server URL to your `mcp_config.json` file under the `mcpServers` key. Cascade immediately auto-discovers the booking tools on this MCP Server and starts using them during your chat sessions.

The `get_availability` tool checks real-time calendar slots first. If a conflict occurs during execution, Cascade stops, reads the error, and picks the next open slot.

Yes, your appointment details and calendar names are protected. This MCP Server runs inside an ephemeral V8 Isolate Sandbox on Vinkius, meaning your credentials never persist and your data is isolated from other processes.

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