How to Use the Cal.com MCP in Windsurf

Q: How do I connect my Cal.com account to Windsurf?

Open your mcpconfig.json file in /.codeium/windsurf/ or use the Cascade settings UI. Add the Cal.com server configuration under the MCP servers block, and Cascade will find the tools on connection.

Q: Does the Cal.com MCP server integration with Windsurf support group event types?

Yes. The server reads your configuration via listeventtypes. Cascade can then set up bookings for any active event format you have configured in your account.

Q: How does the server handle timezone differences?

The server uses getme to find your default timezone. When checking availability, it maps slots against your exact work hours so you never get booked at 3 AM.

Let Windsurf Cascade coordinate your Cal.com bookings and check availability directly from your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cal.com MCP to Windsurf

Create your Vinkius account to connect Cal.com 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 Cal.com with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate calendar booking via the Windsurf MCP Server

Cascade can look at your calendar, find an empty slot, and book it without you clicking around. It queries your timezone and event rules with `get_me` and `list_event_types` to know when you are free. Once it finds a match, the agent runs `create_booking` to lock in the meeting. It handles the back-and-forth planning in one go, without waiting for you to confirm every single step.

Reschedule or cancel meetings instantly

When a client needs to push a meeting, Cascade handles the cleanup. It uses `list_bookings` to find the target event and grabs the details with `get_booking`. You don't have to hunt down the booking ID yourself. The agent then runs `reschedule_booking` to move the slot or `cancel_booking` to clear it out. Both tools send the required email updates automatically so your guests stay in the loop.

Check availability bounds on the fly

Finding a time that works across different zones is annoying. This MCP server lets Cascade run `get_available_slots` to pull the exact blocks where you are free. It maps these against native rules found with `list_schedules`. You get a clean list of options without leaving your workspace. Your agent can read these slots and suggest them to a client or write them directly into an email draft.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "calcom-1-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 Cal.com. 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 Cal.com 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 Cal.com MCP in Windsurf

Open your `mcp_config.json` file in `~/.codeium/windsurf/` or use the Cascade settings UI. Add the Cal.com server configuration under the MCP servers block, and Cascade will find the tools on connection.

Yes. Cascade chains multiple tools together. It will search your active schedule, find the right booking, and run the reschedule tool in one continuous flow without requiring manual steps from you.

Yes. The server reads your configuration via `list_event_types`. Cascade can then set up bookings for any active event format you have configured in your account.

The server uses `get_me` to find your default timezone. When checking availability, it maps slots against your exact work hours so you never get booked at 3 AM.

Yes, your data is fully protected. All credentials and booking details are kept inside Vinkius's secure sandbox. Windsurf only talks to the server through a secure, single-token endpoint, meaning your private calendar details never leak to external logs.

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