How to Use the Google Calendar MCP in Windsurf

Q: How do I find a meeting in Google Calendar using Windsurf?

Ask Cascade to search for the meeting. It uses searchevents to query your calendar and returns the details directly in your chat window.

Q: How does this handle access control?

The server includes listacl to display permissions. You can check who sees your calendar directly from your IDE.

Let Windsurf read your schedule and manage your time directly from the IDE without leaving your code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Google Calendar MCP to Windsurf

Create your Vinkius account to connect Google Calendar 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 Google Calendar with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full-cycle scheduling in Windsurf

Cascade doesn't just read your meetings; it actively manages your time. When you ask it to clear your afternoon, it uses `list_events` to identify conflicts and `delete_event` to remove them. This MCP Server allows Windsurf to chain these actions automatically. You get a clean schedule without manual intervention or context switching.

Context-aware calendar planning

Windsurf evaluates your availability before proposing new meetings. It invokes `check_free_busy` to cross-reference your project deadlines with existing commitments. Once it finds a slot, it uses `create_event` to lock it in. The agent handles the back-and-forth, keeping your calendar updated as your code evolves.

Rapid event entry for developers

Sometimes you just need to drop a reminder on your calendar fast. Cascade uses `quick_add_event` to interpret natural language strings and push them straight to your primary account. It handles the parsing so you stay in the editor. Just tell it what you need, and the MCP Server executes the change in the background.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "google-calendar-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 Google Calendar. 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 Google Calendar 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 Google Calendar MCP in Windsurf

Ask Cascade to search for the meeting. It uses `search_events` to query your calendar and returns the details directly in your chat window.

Yes. If your plans change, tell Windsurf to update the event. It calls `update_event` to modify the time or description based on your current project context.

It does. You can ask for information about any calendar, and it will use `get_calendar_metadata` to show you the settings and permissions.

The server includes `list_acl` to display permissions. You can check who sees your calendar directly from your IDE.

Your event titles and times stay between your local agent and Google. Vinkius operates as a transport layer, meaning no persistent storage of your personal event data occurs.

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