google-calendar-mcp

Level ALocal

MCP integration for Google Calendar to manage events.

Overview

An MCP server that connects Google Calendar to AI assistants like Claude. It supports multiple accounts and calendars in one query, cross-account conflict detection, creating/updating/deleting/searching events, advanced recurring-event edits, free/busy checks, and importing events from images, PDFs, or web links. Authentication works via OAuth or a service account.

⭐ 1.2kOffice & ProductivityTypeScriptRepo ↗Updated 2026-10-29

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "nspady-google-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cocal/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "<PATH_TO_gcp-oauth.keys.json>"
      }
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/nspady/google-calendar-mcp

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "nspady-google-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cocal/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "<PATH_TO_gcp-oauth.keys.json>"
      }
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers