google-calendar-mcp MCP Server

🔔 VERSION UPDATE NOTICE 🔔 Version 2.0.0 moves to MCP protocol revision 2026-07-28 and implements PKCE on the OAuth flow. It requires Node.js 20 or newer. See the version history below for the full…

Local serverstdioMIT

What is the google-calendar-mcp Server?

google-calendar-mcp is an MCP project maintained in the takumi0706/google-calendar-mcp repository. The maintainer describes its purpose as “🔔 VERSION UPDATE NOTICE 🔔 Version 2.0.0 moves to MCP protocol revision 2026-07-28 and implements PKCE on the OAuth flow. It requires Node.js 20 or…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @takumi0706/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_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REDIRECT_URI. 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
calendarIdoptional): Calendar ID (uses primary calendar if omitted)
timeMinoptional): Start time for event retrieval (ISO 8601 format, e.g., "2025-03-01T00:00:00Z"). Empty strings, null, or undefined values are ignored
timeMaxoptional): End time for event retrieval (ISO 8601 format). Empty strings, null, or undefined values are ignored
maxResultsoptional): Maximum number of events to retrieve (default: 10)
orderByoptional): Sort order ("startTime" or "updated"). Defaults to "startTime" if empty string, null, or undefined
eventEvent details object containing fields to update (same structure as createEvent, all fields optional)
summaryrequired): Event title
locationoptional): Event location
startStart time object with:
dateTimeoptional): ISO 8601 format (e.g., "2025-03-15T09:00:00+09:00")
dateoptional): YYYY-MM-DD format for all-day events
timeZoneoptional): Time zone (e.g., "Asia/Tokyo")
endEnd time object (same format as start)
attendeesoptional): Array of attendees with email and optional displayName
colorIdoptional): Event color ID (1-11)
recurrenceoptional): Array of recurrence rules in RFC5545 format (e.g., ["RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR"])
eventIdrequired): ID of the event to delete

How to install the google-calendar-mcp Server

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@takumi0706/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "YOUR_GOOGLE_CLIENT_SECRET",
        "GOOGLE_REDIRECT_URI": "http://localhost:4153/oauth2callback"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
GOOGLE_CLIENT_IDDeclared in the maintainer’s client configuration.Check documentation
GOOGLE_CLIENT_SECRETDeclared in the maintainer’s client configuration.Check documentation
GOOGLE_REDIRECT_URIDeclared in the maintainer’s client configuration.Check documentation