Integrations
Provides tools for managing Google Calendar, including listing calendars, creating/reading/updating/deleting events, and fetching events between specified dates with OAuth 2.0 authentication.
Google カレンダー MCP サーバー
TypeScript で構築され、Google カレンダーと統合されるモデル コンテキスト プロトコル (MCP) サーバーです。
特徴
- OAuth 2.0 認証による Google カレンダーのシームレスな統合
- 自動認証のための永続的なトークンストレージ
- 包括的なイベント操作でカレンダーを一覧表示および管理します
- カレンダーイベントの作成、読み取り、更新、削除
- 指定した日付間のカレンダーイベントを取得します
- リアルタイム更新のための Server-Sent Events (SSE) トランスポート オプション
- Claude やその他の MCP 対応 AI アシスタントとのシンプルな統合
インストール
または、次のコマンドを直接実行します:
前提条件
- Node.js (v16 以上)
- Google Cloud Platform アカウント
- GoogleカレンダーAPIが有効
- OAuth 2.0 認証情報
設定
1. Google Cloud の構成
- Google Cloud Consoleに移動
- 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
- Google カレンダー API を有効にします。
- 「APIとサービス」>「ライブラリ」に移動します
- 「Google カレンダー API」を検索
- 「有効にする」をクリックします
- OAuth 同意画面を設定します。
- 「APIとサービス」>「OAuth同意画面」に移動します
- 「外部」ユーザータイプ(Google Workspace の場合は「内部」)を選択します
- 必要な情報を入力してください:
- アプリ名: mcp-calendar
- ユーザーサポートメール: (あなたのメールアドレス)
- 開発者の連絡先情報: (メールアドレス)
- スコープを追加します:
- 「スコープの追加または削除」をクリックします
- 「 https://www.googleapis.com/auth/calendar.events 」を見つけて選択します
- テストユーザーとしてメールアドレスを追加する
- セットアップを完了する
- OAuth 資格情報を作成します。
- 「資格情報」へ移動
- 「認証情報を作成」>「OAuthクライアントID」をクリックします。
- アプリケーションの種類として「デスクトップアプリ」を選択します
- 名前を付けます(例:「MCP カレンダー デスクトップ クライアント」)
- JSONファイルをダウンロードし、プロジェクトディレクトリに
credentials.json
として保存します。
2. 環境設定
プロジェクト ルートに.env
ファイルを作成します。
使用法
サーバーの起動
標準の WebSocket から始めましょう:
サーバー送信イベント (SSE) から開始します。
クロード・デスクトップ
これをclaude_desktop_config.json
に追加します:
認証プロセス
サーバーを初めて実行する場合:
- ブラウザウィンドウが自動的に開きます
- Googleアカウントでログイン
- 要求されたカレンダーの権限を付与する
- 認証トークンは
token.json
に保存されます。
以降の起動時:
- サーバーは保存されたトークンを自動的に使用します
- トークンの有効期限が切れない限り、ブラウザの操作は必要ありません
利用可能なツール
道具 | 説明 |
---|---|
list_calendars | 利用可能なすべてのカレンダーを取得する |
list_calendar_events | 指定した日付間のイベントを取得する |
create_calendar_event | カレンダーに新しいイベントを追加する |
get_calendar_event | 特定のイベントの詳細を取得する |
edit_calendar_event | 既存のカレンダーイベントを変更する |
delete_calendar_event | カレンダーからイベントを削除する |
発達
プロジェクトのクローンを作成してセットアップします。
プロジェクトをビルドします。
開発モードで実行:
セキュリティに関する考慮事項
⚠️重要なセキュリティ警告⚠️
credentials.json
とtoken.json
には機密の認証情報が含まれています- これらのファイルをバージョン管理にコミットしたり、公開したりしないでください。
- 各ユーザーは独自のOAuth認証情報を作成する必要があります
- 認証情報が侵害された疑いがある場合は、Google Cloud Console で直ちに取り消してください。
- トークンはGoogleカレンダーデータへのアクセスを許可します
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。
- リポジトリをフォークする
- 機能ブランチを作成します(
git checkout -b feature/amazing-feature
) - 変更をコミットします (
git commit -m 'Add some amazing feature'
) - ブランチにプッシュする (
git push origin feature/amazing-feature
) - プルリクエストを開く
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
モデル コンテキスト プロトコルを通じて Google カレンダーを AI アシスタントと統合し、ユーザーが自然言語による対話を通じてカレンダー イベントを表示および管理できるようにします。
Related MCP Servers
- -securityFlicense-qualityGoogle Calendar integration in Cursor IDE. This server enables AI assistants to manage Google Calendar events through natural language interactions.Last updated -505JavaScript
- -securityAlicense-qualityServer for Google Calendar integration in Cluade Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar events through natural language interactions.Last updated -226JavaScriptMIT License
- -securityFlicense-qualityAllows interaction with Google Calendar through Claude Desktop using the Model Context Protocol, enabling calendar event management and schedule analysis.Last updated -2JavaScript
- -securityAlicense-qualityA Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.Last updated -13321TypeScriptMIT License