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

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

What it needs from you

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

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

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

Google Calendar MCP Server with extensive support for calendar management Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.