Google MCP Server

Google Calendar MCP Server with extensive support for calendar management

Local serverstdioGo

What is the Google MCP server?

Google Calendar MCP Server with extensive support for calendar management. That is what the google mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

A Model Context Protocol (MCP) server that provides Google Calendar integration for AI assistants like Claude.

  • Multi-Account Support — Connect multiple Google accounts (e.g., work, personal) and query them simultaneously
  • Multi-Calendar Support — List events from multiple calendars in a single request
  • Cross-Account Conflicts — Detect overlapping events across any combination of calendars
  • Event Management — Create, update, delete, and search calendar events
  • Recurring Events — Advanced modification capabilities for recurring events
  • Free/Busy Queries — Check availability across calendars

Getting it running

Installation goes through your MCP client rather than a global install: point it at Users on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • list-calendars — List all available calendars
  • list-events — List events with date filtering
  • get-event — Get details of a specific event by ID
  • search-events — Search events by text query
  • create-event — Create new calendar events
  • update-event — Update existing events
  • delete-event — Delete events
  • respond-to-event — Respond to event invitations (Accept, Decline, Maybe, No Response)
  • get-freebusy — Check availability across calendars, including external calendars
  • get-current-time — Get current date and time in calendar's timezone
  • list-colors — List available event colors
  • manage-accounts — Add, list, or remove connected Google accounts

What it needs from you

Configuration is passed through the environment: GOOGLE_OAUTH_CREDENTIALS, ENABLED_TOOLS, GOOGLE_CALENDAR_MCP_TOKEN_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  1. A Google Cloud project with the Calendar API enabled 2. OAuth 2.0 credentials (Desktop app type)

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Google.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Google's toolset — list-calendars, list-events, get-event and 11 more — is a fair guide to whether it matches your workflow. It is maintained by GitHub Actions; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
list-calendarsList all available calendars
list-eventsList events with date filtering
get-eventGet details of a specific event by ID
search-eventsSearch events by text query
create-eventCreate new calendar events
update-eventUpdate existing events
delete-eventDelete events
respond-to-eventRespond to event invitations (Accept, Decline, Maybe, No Response)
get-freebusyCheck availability across calendars, including external calendars
get-current-timeGet current date and time in calendar's timezone
list-colorsList available event colors
manage-accountsAdd, list, or remove connected Google accounts
Prerequisites1. A Google Cloud project with the Calendar API enabled 2. OAuth 2.0 credentials (Desktop app type)
InstallationThen add to Claude Desktop config using the local path or by specifying the path with the GOOGLE_OAUTH_CREDENTIALS environment variable.

How to install the Google MCP server

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  1. A Google Cloud project with the Calendar API enabled 2. OAuth 2.0 credentials (Desktop app type)
VariableDescriptionRequired
GOOGLE_OAUTH_CREDENTIALSConfiguration value read at startup.Optional
ENABLED_TOOLSConfiguration value read at startup.Optional
GOOGLE_CALENDAR_MCP_TOKEN_PATHCredential the server authenticates with.Yes

Example prompts to try

  • Use Google to list-calendars.
  • Use Google to list-events.
  • Use Google to get-event.

Frequently asked questions

It connects Google to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (list-calendars, list-events, get-event, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Google directly.