google-calendar-mcp MCP Server

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

Local serverstdioMIT

What is the google-calendar-mcp Server?

google-calendar-mcp is an MCP project maintained in the nspady/google-calendar-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that provides Google Calendar integration for AI assistants like Claude”. Read the project documentation for the complete scope.

Installation

The documented npm package is @cocal/google-calendar-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares GOOGLE_OAUTH_CREDENTIALS. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

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
create-eventsCreate multiple events in one call with shared defaults (skips conflict detection)
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
SecurityRestrict capabilities to read-only operations or specific functionality.
SimplicityOnly expose the tools your workflow actually needs.

How to install the google-calendar-mcp Server

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "@cocal/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "YOUR_GOOGLE_OAUTH_CREDENTIALS"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GOOGLE_OAUTH_CREDENTIALSDeclared in the maintainer’s client configuration.Check documentation