Google Calendar MCP

Google Calendar MCP gives your AI coding agent two tools for reading your schedule and one admin tool for changing it, so you can check what is coming up or book a meeting without leaving the editor. It is free, it runs as a VS Code extension, and it talks to your own Google account.

There is no server to host and no config file to edit. You install the extension, sign in to Google once, and the Calendar tools appear in every agent it finds on your machine: VS Code Copilot, Claude Code, Cursor, OpenAI Codex, Google Gemini, Windsurf, Continue.dev, and Cline.

What you can ask

  • “What meetings do I have today?”
  • “Show me the details of my 3pm meeting”
  • “Am I free on Friday afternoon?”
  • “Book a 30 minute review with the team on Tuesday at 10”
  • “Move the planning call to Thursday”
  • “Which calendars do I have?”

The two Google Calendar MCP tools

Tool What it does
calendar_list_events List upcoming events with attendees, location, and times
calendar_get_event Get the full details of one event

calendar_list_events reads your primary calendar from now onward unless you say otherwise. Name another calendar or a date range and the agent passes that along.

The Calendar admin tool

Anything that changes your schedule goes through one admin tool with named actions.

Action What it does
create_event Create a new event
update_event Change an event’s details
delete_event Delete an event (needs confirmation)
list_calendars List all your calendars
create_calendar Create a new calendar

Deleting an event needs explicit confirmation

The delete_event action only runs with confirm: true. The agent is told this up front, so it has to ask you before it removes a meeting. Reading events and listing calendars do not need it.

Connecting your Google account

A setup wizard opens the first time you launch the extension. Most people pick OAuth.

  1. Create a project in the Google Cloud Console, or pick one you already have.
  2. Enable the Google Calendar API under APIs and Services.
  3. Create an OAuth client ID of type Desktop app.
  4. Paste the client ID and secret into the wizard.
  5. Sign in to Google in the browser window that opens, and authorize.

Developers who already use the gcloud CLI can use Application Default Credentials instead, and Workspace admins can use a service account key.

Common questions

Does it cover other Google services?

Yes. The same install also gives you the Gmail, Google Drive, Docs, and Sheets tools.

Can it read more than one calendar?

Yes. list_calendars shows every calendar on your account, and the event tools accept a calendar ID, so you can ask about a shared or team calendar by name.

Install it

Google Calendar MCP is free and MIT licensed. In the extension stores it is listed as Google Workspace MCP, the package that carries the Calendar tools.

Related