takumi0706/google-calendar-mcp
Free与 Google Calendar API 交互的 MCP 服务器 (TypeScript 版)。
FreeFree tier
About takumi0706/google-calendar-mcp
Google Calendar MCP Server is an open-source MCP (Model Context Protocol) implementation that bridges Google Calendar with Claude Desktop. It enables Claude to interact with the user's Google Calendar through natural language, allowing users to display, create, update, and delete calendar events. The server uses OAuth2 for secure authentication, supports recurring events (as of v1.0.5), and provides color customization via colorId. Built with TypeScript, it leverages the MCP SDK, Google APIs, Hono for the auth server, Zod for schema validation, and AES-256-GCM for token encryption. Communication is handled via STDIO transport, making it suitable for integration with Claude Desktop.
Key Features
Natural language calendar management through Claude Desktop
Comprehensive event operations: get, create, update, delete events
OAuth2 authentication with Google API for secure access
Recurring event support (added in v1.0.5)
Event color customization using colorId parameter
STDIO transport for seamless Claude Desktop integration
Schema validation with Zod for data integrity
AES-256-GCM encryption for token security
TypeScript-based for type-safe development
Supports filtering events by time range and calendar ID
Pros & Cons
Pros
- Enables AI-powered calendar management directly within Claude Desktop
- Supports comprehensive CRUD operations on events
- Secure authentication via OAuth2 with token encryption
- Actively maintained with version updates (e.g., recurring events)
- Open-source and free to use
- Written in TypeScript for robustness and maintainability
Cons
- Requires self-hosting and manual setup of Google API credentials
- Limited to Google Calendar; no support for other calendar services
- Only works with Claude Desktop (not other AI assistants without MCP support)
- No built-in GUI; relies on terminal/STDIO for operation
- Users must be comfortable with Git, TypeScript, and OAuth2 setup
Best For
Query upcoming events from Google Calendar via Claude chatCreate and schedule new events using natural language commandsUpdate or reschedule existing calendar entriesDelete unwanted events without leaving Claude DesktopManage recurring events like weekly meetings or remindersAutomate calendar workflows as part of AI-assisted productivity
FAQ
What is Google Calendar MCP Server?
It is an open-source MCP server that allows Claude Desktop to interact with Google Calendar via natural language, supporting event creation, viewing, updating, and deletion.
Does it support recurring events?
Yes, version 1.0.5 and later support creating and modifying recurring events through the recurrence parameter in createEvent and updateEvent tools.
How does authentication work?
It uses OAuth2 with PKCE flow via Google APIs. The authentication handler manages token encryption using AES-256-GCM for security.
Is this tool free?
Yes, it is open-source and free to use. Users only need their own Google Calendar and Claude Desktop accounts.