Google カレンダー MCP サーバー

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

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

• MCP URI によるカレンダーイベント管理

• イベントを作成および変更するためのツール

• カレンダーの分析情報を生成するためのプロンプト

特徴

リソース

• MCP URI 経由でカレンダー イベントにアクセスする

• 各イベントにはタイトル、時間、説明、参加者が登録されています

• 適切なMIMEタイプで構造化されたイベントデータ

ツール

• create_event - 新しいカレンダーイベントを作成する

  • タイトル、時間、その他のイベントの詳細をパラメータとして受け取ります

  • Google カレンダー API と直接インターフェースします

• list_events - 今後のカレンダーイベントを表示する

• [実装した他のツールを追加]

プロンプト

• analyze_schedule - カレンダーに関する洞察を生成する

  • 今後のイベントを埋め込みリソースとして含める

  • LLM分析のための構造化されたプロンプトを返します

• [実装した他のプロンプトを追加]

Related MCP server: Calendar Tools MCP Server

前提条件

• Node.js (v14以上)

• カレンダー API が有効になっている Google Cloud プロジェクト

• OAuth 2.0 クライアント資格情報

発達

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

curl -fsSL https://get.jetpack.io/devbox | bash

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

devbox init

devbox シェルを起動します。

devbox shell

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

npm install

サーバーを構築します。

npm run build

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

npm run watch

インストール

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

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

{
  "mcpServers": {
    "Google Calendar": {
      "command": "/path/to/Google Calendar/build/index.js"
    }
  }
}

初回セットアップ

1. Google Cloud の認証情報を設定します。

   • Google Cloud Consoleに移動

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

   • GoogleカレンダーAPIを有効にする

   • OAuth 2.0 認証情報を作成する (デスクトップ アプリケーション タイプ)

   • クライアントシークレットJSONファイルをダウンロードする

   • 名前を.client_secret.jsonに変更し、プロジェクトルートに配置します。

2. 初期認証:

   • サーバーを初めて起動すると、認証URLが提供されます。

   • ブラウザでURLにアクセスしてください

   • 要求された権限を付与する

   • 提供された認証コードをコピーします

   • コードをCLIプロンプトに貼り付けます

デバッグ

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

npm run inspector

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