@cocal/google-calendar-mcp
A TypeScript MCP server for Google Calendar, published on npm as @cocal/google-calendar-mcp.
What it does
A TypeScript MCP server for Google Calendar, published on npm as @cocal/google-calendar-mcp. It can read several Google accounts and calendars at once, flag overlapping events across them, create, update, delete and search events, edit recurring series, query free and busy times, and add events from images, PDFs or links. The user creates a Google Cloud OAuth desktop client and points the server at its key file; on first use the agent is asked to start the browser sign-in. A service account can be used instead for headless setups. It runs locally via npx or Docker, with an HTTP mode described for Docker.
Capabilities
- Read events across several Google accounts and calendars
- Detect conflicting events
- Create, update, delete and search events, including recurring ones
- Query free and busy times
- Add events from images, PDFs or links
About
- Publisher
- nspady
- Tool
- Google Calendar
Works with
Install
- Add this to Claude Desktop's configuration:
{ "mcpServers": { "google-calendar": { "command": "npx", "args": ["@cocal/google-calendar-mcp"], "env": { "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json" } } } }
From the project's documentation · Add to a config file with the config builder
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Google Calendar | |
| Publisher | nspady | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local (runs on your computer) | source |
| Can change data | Yes | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Claude Desktop | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Oct 29, 2026Version 2.8.11,215 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website npm: @cocal/google-calendar-mcp |
Sources
- GitHub repositorygithub.com/nspady/google-calendar-mcp · Backs: AI clients, Can change data, Connection, Needs an API key or sign-in, Official status, Publisher, Activity, LicenceNov 10, 2026
- Licence file (LICENSE)github.com/nspady/google-calendar-mcp · Backs: LicenceNov 12, 2026
- npm package recordnpmjs.com/package/@cocal/google-calendar-mcpNov 10, 2026