How to Use the Cal.com MCP in Windsurf

Windsurf Cascade handles your calendar directly. Schedule meetings and manage booking links without leaving the editor.

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

Autonomous scheduling inside Windsurf

The `create_new_booking` tool in this MCP Server lets Cascade book meetings for you while you code. You tell the agent to set up a sync with your lead developer next Tuesday. Cascade checks your working hours using `list_availability_schedules`, finds a free slot, and puts it on the calendar. You never switch to a browser tab. The agent chains these steps together based on your text prompt. If the meeting needs to move later, Cascade fires `reschedule_meeting` and updates the invite automatically.

Manage event types via MCP

The `list_event_types` tool pulls your meeting templates directly into the IDE. Ask Cascade to audit your scheduling pages, and it grabs the data to show you exactly which templates are active. It reads the specific settings using `get_event_type_details`. This server exposes your integration connections right in your workspace. Cascade calls `list_active_webhooks` to verify that your booking events fire off correctly to your external logging services.

Check availability across schedules

The `get_available_slots` tool queries your calendar for open time blocks. You ask Windsurf to find 30 minutes for a code review before Friday. The agent pulls the data and presents the options right in your chat panel. It avoids conflicts by checking your existing commitments with `list_bookings`. If you need to drop a meeting to make room, the agent runs `cancel_booking` and frees up the slot immediately.

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-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 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 Settings, go to Cascade, and find the MCP Servers UI. You add the server to your configuration file there. Click Refresh in the panel to load the tools.

Yes. You give Cascade a prompt like 'book a 15-minute sync with Dave tomorrow'. The agent reads your available slots and creates the booking without asking you for step-by-step confirmation.

You just tell the agent to move a specific meeting. It calls the update tool and shifts the calendar event to a new time block.

Run a prompt asking the agent to check the connection. It executes `test_cal_auth` and returns the current status of your API token.

Vinkius routes your calendar blocks and attendee email addresses through an ephemeral V8 Isolate sandbox. The environment spins up for the exact duration of the API call and destroys itself immediately after returning the data.

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