takumi0706/google-calendar-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Claudeデスクトップ統合のためのGoogleカレンダーMCPサーバー
概要
バージョン 2.0.0 は MCP プロトコルのリビジョン 2026-07-28 に移動し、 OAuth フローに PKCE を実装します。 お問い合わせ 変更の完全なリストについては、以下のバージョン履歴を参照してください。 Google Calendar MCP Server は、Google Calendar と Claude Desktop の統合を可能にする MCP (Model Context Protocol) サーバーの実装です。 このプロジェクトでは、Claude がユーザーの Google カレンダーとやり取りし、自然言語のやりとりを通じてカレンダー イベントを表示、作成、更新、削除する機能を提供します.
概要（AI 翻訳）
** 過剰なバージョンの更新通知** バージョン 2.0.0 は MCP プロトコルリビジョン
2026-07-28に移動し、OAuth フローに PKCE を実装します。 Node.js 20 または newer が必要です。 変更の完全なリストについては、以下のバージョン履歴を参照してください。
プロジェクト概要
Google Calendar MCP Server は、Google Calendar と Claude Desktop の統合を可能にする MCP (Model Context Protocol) サーバーの実装です。 このプロジェクトでは、Claude がユーザーの Google カレンダーとやり取りし、自然言語のやりとりを通じてカレンダー イベントを表示、作成、更新、削除する機能を提供します。
コア機能
- Googleカレンダーの統合: Claude DesktopとGoogle Calendar APIのブリッジを提供
- MCPの実装: AIアシスタントツールの統合のためのモデルコンテキストプロトコル仕様に従ってください
- OAuth2 認証: Google API 認証フローを安全に処理
- イベント管理: 包括的なカレンダーイベント操作をサポート(ウィジェット、作成、更新、削除)
- 色サポート:colorIdパラメーターを使用してイベントの色を設定し、更新する機能
- STDIOトランスポート: Claudeデスクトップと通信するための標準的な入出力を使用する
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
Google Calendar MCP Server
🔔 VERSION UPDATE NOTICE 🔔
Version 2.0.0 moves to MCP protocol revision2026-07-28and implements PKCE on the OAuth flow. It requires Node.js 20 or newer. See the version history below for the full list of changes.
Project Overview
Google Calendar MCP Server is an MCP (Model Context Protocol) server implementation that enables integration between Google Calendar and Claude Desktop. This project enables Claude to interact with the user’s Google Calendar, providing the ability to display, create, update, and delete calendar events through natural language interaction.
Core Features
- Google Calendar integration: Provides a bridge between Claude Desktop and the Google Calendar API
- MCP implementation: Follows the Model Context Protocol specification for AI assistant tool integration
- OAuth2 authentication: Handles the Google API authentication flow securely
- Event management: Supports comprehensive calendar event operations (get, create, update, delete)
- Color support: Ability to set and update event colors using colorId parameter
- STDIO transport: Uses standard input/output for communication with Claude Desktop
Technical Architecture
This project uses:
- TypeScript: For type-safe code development
- MCP SDK: Uses
@modelcontextprotocol/serverv2 (protocol revision2026-07-28, with the 2025 revisions still served for older clients) - Google API: Uses
googleapisfor Google Calendar API access - Hono: Lightweight and fast web framework for the authentication server
- google-auth-library: Drives the OAuth2 authorization code flow with PKCE (S256)
- Zod: Implements schema validation for request/response data
- Environment-based configuration: Uses dotenv for configuration management
- AES-256-GCM: For token encryption using Node.js crypto module
- Open: For automatic browser launching during authentication
- Readline: For manual authentication input in server environments
- Jest: For unit testing and coverage
- GitHub Actions: For CI/CD
Main Components
- MCP Server: Core server implementation that handles communication with Claude Desktop
- Google Calendar Tools: Calendar operations (retrieval, creation, update, deletion)
- Authentication Handler: Management of OAuth2 flow with Google API
- Schema Validation: Ensuring data integrity in all operations
- Token Manager: Secure handling of authentication tokens
Available Tools
インストール
npx -y @takumi0706/google-calendar-mcp設定
{
"mcpServers": {
"google-calendar": {
"command": "npx",
"args": [
"-y",
"@takumi0706/google-calendar-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "your_client_id",
"GOOGLE_CLIENT_SECRET": "your_client_secret",
"GOOGLE_REDIRECT_URI": "http://localhost:4153/oauth2callback"
}
}
}
}