Google カレンダー MCP サーバー

モデル コンテキスト プロトコル (MCP) を使用して、Claude Desktop から Google カレンダーを操作します。

これは、Googleカレンダーとの連携を実装したTypeScriptベースのMCPサーバーです。MCPのコアコンセプトを実証しながら、以下の機能を提供します。

• MCP URI によるカレンダーイベント管理
• イベントを作成および変更するためのツール
• カレンダーの分析情報を生成するためのプロンプト

特徴

リソース

• MCP URI 経由でカレンダー イベントにアクセスする
• 各イベントにはタイトル、時間、説明、参加者が登録されています
• 適切なMIMEタイプで構造化されたイベントデータ

ツール

• create_event - 新しいカレンダーイベントを作成する
  • タイトル、時間、その他のイベントの詳細をパラメータとして受け取ります
  • Google カレンダー API と直接インターフェースします
• list_events - 今後のカレンダーイベントを表示する
• [実装した他のツールを追加]

プロンプト

• analyze_schedule - カレンダーに関する洞察を生成する
  • 今後のイベントを埋め込みリソースとして含める
  • LLM分析のための構造化されたプロンプトを返します
• [実装した他のプロンプトを追加]

前提条件

• Node.js (v14以上)
• カレンダー API が有効になっている Google Cloud プロジェクト
• OAuth 2.0 クライアント資格情報

発達

devbox.shの指示に従ってdevboxをインストールします。

プロジェクト ディレクトリで devbox を初期化します。

devbox シェルを起動します。

依存関係をインストールします:

サーバーを構築します。

自動リビルドを使用した開発の場合:

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

初回セットアップ

1. Google Cloud の認証情報を設定します。
   • Google Cloud Consoleに移動
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
   • GoogleカレンダーAPIを有効にする
   • OAuth 2.0 認証情報を作成する (デスクトップ アプリケーション タイプ)
   • クライアントシークレットJSONファイルをダウンロードする
   • 名前を.client_secret.jsonに変更し、プロジェクトルートに配置します。
2. 初期認証:
   • サーバーを初めて起動すると、認証URLが提供されます。
   • ブラウザでURLにアクセスしてください
   • 要求された権限を付与する
   • 提供された認証コードをコピーします
   • コードをCLIプロンプトに貼り付けます

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。