Google Calendar MCP

Google Calendar MCP server for Claude Code, Cursor, Copilot and five more AI agents. Connect Google Calendar to Claude, Copilot, Cursor, Codex, Gemini, Windsurf, Continue.dev and Cline. One extension, 8 agents, no config files to edit.

Install. Sign in with Google. Ask your AI agent to work with Google Calendar.

Install this or Google Workspace MCP, not both.

Quick Start

Install from the VS Code Marketplace or Open VSX
Authenticate: the setup wizard appears on first launch
Ask your AI agent anything about Google Calendar

"What meetings do I have today?"
"Am I free Thursday afternoon?"
"Schedule a call with Ana on Friday at 3pm"
"Move my dentist appointment to next week"

Prerequisites

You need one of these (the wizard will guide you):

Method	Best For	What You Need
OAuth (recommended)	Personal Google accounts	A Google Cloud project with OAuth credentials
ADC	Developers with `gcloud` CLI	Run one terminal command
Service Account	Workspace admins	A JSON key file

Go to Google Cloud Console
Create a project (or select an existing one)
Enable the Google Calendar API under APIs & Services > Library
Create OAuth credentials:
- Go to APIs & Services > Credentials
- Click Create Credentials > OAuth client ID
- Application type: Desktop app
- Copy the Client ID and Client Secret
Configure the OAuth consent screen (if prompted) and add yourself as a test user
In the extension wizard, select "OAuth" and paste your Client ID and Secret
A browser window opens: sign in with your Google account and authorize

Option B: Application Default Credentials

gcloud auth application-default login \
  --scopes=https://www.googleapis.com/auth/calendar.readonly

Option C: Service Account Key

Create a service account in Google Cloud Console
Share the files or calendars with the service account, or enable domain-wide delegation
Download the JSON key file
In the extension wizard, select "Service Account" and pick the file

Available Tools (4)

Calendar (2 tools)

Tool	What It Does	Example Prompt
`calendar_list_events`	List upcoming events	"What meetings do I have today?"
`calendar_get_event`	Get full event details	"Show me the details of my 3pm meeting"

Calendar Admin (mega-tool)

Action	Description
`create_event`	Create a new calendar event
`update_event`	Update event details
`delete_event`	Delete an event (requires confirm)
`list_calendars`	List all calendars
`create_calendar`	Create a new calendar

Safety

Destructive actions (delete, trash, clear) require confirm: true to execute. The AI agent will be warned and must explicitly confirm before proceeding.

Supported AI Agents

The extension auto-registers with every AI agent it detects:

Settings

Setting	Default	Description
`gcalMcp.authMethod`	`"oauth"`	Auth method: oauth, adc, serviceAccount
`gcalMcp.agents.*`	`true`	Per-agent registration toggles
`gcalMcp.registrationScope`	`"global"`	Global or workspace registration
`gcalMcp.autoStart`	`true`	Auto-start server on VS Code launch
`gcalMcp.serverLogLevel`	`"info"`	Server log verbosity

Commands

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for:

Command	What It Does
`Google Calendar MCP: Setup Authentication`	Run the setup wizard
`Google Calendar MCP: Register with AI Agents`	Re-register with all detected agents
`Google Calendar MCP: Show Status`	Show auth method and server state
`Google Calendar MCP: Restart MCP Server`	Restart the background MCP server
`Google Calendar MCP: Check Authentication Status`	Verify credentials are valid
`Google Calendar MCP: View Server Logs`	Open the output channel for debugging
`Google Calendar MCP: Remove from All Agents`	Clean up all agent registrations

Troubleshooting