Google カレンダー MCP サーバー

TypeScript で構築され、Google カレンダーと統合されるモデル コンテキスト プロトコル (MCP) サーバーです。

特徴

• OAuth 2.0 認証による Google カレンダーのシームレスな統合

• 自動認証のための永続的なトークンストレージ

• 包括的なイベント操作でカレンダーを一覧表示および管理します

• カレンダーイベントの作成、読み取り、更新、削除

• 指定した日付間のカレンダーイベントを取得します

• リアルタイム更新のための Server-Sent Events (SSE) トランスポート オプション

• Claude やその他の MCP 対応 AI アシスタントとのシンプルな統合

インストール

または、次のコマンドを直接実行します:

前提条件

1. Node.js (v16 以上)

2. Google Cloud Platform アカウント

3. GoogleカレンダーAPIが有効

4. OAuth 2.0 認証情報

設定

1. Google Cloud の構成

1. Google Cloud Consoleに移動

2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください

3. Google カレンダー API を有効にします。

   • 「APIとサービス」>「ライブラリ」に移動します

   • 「Google カレンダー API」を検索

   • 「有効にする」をクリックします

4. OAuth 同意画面を設定します。

   • 「APIとサービス」>「OAuth同意画面」に移動します

   • 「外部」ユーザータイプ（Google Workspace の場合は「内部」）を選択します

   • 必要な情報を入力してください:

     • アプリ名: mcp-calendar

     • ユーザーサポートメール: (あなたのメールアドレス)

     • 開発者の連絡先情報: (メールアドレス)

   • スコープを追加します:

     • 「スコープの追加または削除」をクリックします

     • 「 https://www.googleapis.com/auth/calendar.events 」を見つけて選択します

     • テストユーザーとしてメールアドレスを追加する

   • セットアップを完了する

5. OAuth 資格情報を作成します。

   • 「資格情報」へ移動

   • 「認証情報を作成」>「OAuthクライアントID」をクリックします。

   • アプリケーションの種類として「デスクトップアプリ」を選択します

   • 名前を付けます（例：「MCP カレンダー デスクトップ クライアント」）

   • JSONファイルをダウンロードし、プロジェクトディレクトリにcredentials.jsonとして保存します。

2. 環境設定

プロジェクト ルートに.envファイルを作成します。

使用法

サーバーの起動

標準の WebSocket から始めましょう:

サーバー送信イベント (SSE) から開始します。

クロード・デスクトップ

これをclaude_desktop_config.jsonに追加します:

認証プロセス

サーバーを初めて実行する場合:

1. ブラウザウィンドウが自動的に開きます

2. Googleアカウントでログイン

3. 要求されたカレンダーの権限を付与する

4. 認証トークンはtoken.jsonに保存されます。

以降の起動時:

• サーバーは保存されたトークンを自動的に使用します

• トークンの有効期限が切れない限り、ブラウザの操作は必要ありません

利用可能なツール

発達

プロジェクトのクローンを作成してセットアップします。

プロジェクトをビルドします。

開発モードで実行:

セキュリティに関する考慮事項

⚠️重要なセキュリティ警告⚠️

• credentials.jsonとtoken.jsonには機密の認証情報が含まれています

• これらのファイルをバージョン管理にコミットしたり、公開したりしないでください。

• 各ユーザーは独自のOAuth認証情報を作成する必要があります

• 認証情報が侵害された疑いがある場合は、Google Cloud Console で直ちに取り消してください。

• トークンはGoogleカレンダーデータへのアクセスを許可します

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く