How to Use the SimplyBook.me MCP in Windsurf

Q: Can I list all clients through SimplyBook.me and Windsurf?

Yes. You just call listclients. This gives your agent a complete roster of every company client record stored on SimpleBook.me, letting you review them all in the MCP panel.

Q: What if I need to cancel an appointment using SimplyBook.me and Windsurf?

You use the cancelbooking tool. Just remember that action is irreversible. The agent makes sure you know what you're doing before it sends the cancellation request through the MCP Server.

Q: Does SimplyBook.me support multiple service units?

Absolutely. You can use listunits to get a list of all available providers or locations, and then check their combined availability using getworkcalendar.

Q: How do I verify existing booking details with SimplyBook.me and Windsurf?

You grab the specific ID and call getbookingdetails. It pulls up everything about that one appointment, including who it was for and what services were booked.

Automate complex scheduling logic for SimplyBook.me with Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect SimplyBook.me MCP to Windsurf

Create your Vinkius account to connect SimplyBook.me to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup SimplyBook.me with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Multi-step Booking Creation via MCP Server

You set a goal—like booking a client appointment—and Cascade handles the rest. It first checks available services using `list_services`, then verifies open slots for staff through `get_work_calendar`, and finally executes the reservation with `create_booking`. This process means you don't have to prompt Windsurf for each step. The agent figures out the necessary sequence of tool calls automatically, ensuring the booking is valid before it hits SimplyBook.me.

Managing Client Records on SimplyBook.me

Need to update a client's details or check their history? Just call `list_clients` and you get a roster of all company clients. You can then use `update_booking` to modify an existing appointment, keeping the record clean and current. The MCP Server makes sure that when Windsurf modifies data via SimpleBook.me, it follows the exact rules needed for client integrity.

Checking Staff Capacity with SimplyBook.me

Before proposing a change, you need to know if someone's free. The agent uses `get_work_calendar` to check availability across specific staff units using `list_units`. It shows real-time capacity so you don't overbook anyone. This tool is key because it checks the current state of the work calendar against your desired time, making sure any booking proposed through the MCP Server actually works.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "simplybookme-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 SimplyBook.me. 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 SimplyBook.me 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 SimplyBook.me MCP in Windsurf

Windsurf handles complexity by chaining tool calls automatically. Instead of prompting for service IDs, calendar checks, and booking creation separately, it runs the whole workflow in one go using the MCP Server.

Yes. You just call `list_clients`. This gives your agent a complete roster of every company client record stored on SimpleBook.me, letting you review them all in the MCP panel.

You use the `cancel_booking` tool. Just remember that action is irreversible. The agent makes sure you know what you're doing before it sends the cancellation request through the MCP Server.

Absolutely. You can use `list_units` to get a list of all available providers or locations, and then check their combined availability using `get_work_calendar`.

You grab the specific ID and call `get_booking_details`. It pulls up everything about that one appointment, including who it was for and what services were booked.

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