Google Calendar MCP Server

🚀 谷歌日历 MCP サーバ

Claude Desktop を使用して、モデルコンテキストプロトコル（MCP）を介して Google Calendar とやり取りできます。

これは TypeScript ベースの MCP サーバで、Google カレンダーとの統合を実現します。このサーバは、MCP の核心概念をデモンストレーションすると同時に、以下の機能を提供します。

• MCP URI を通じたカレンダーイベントへのアクセス
• イベントの作成と修正ツール
• カレンダーの洞察を自動生成するプロンプト

✨ 主な機能

リソース

• MCP URI を通じてカレンダーイベントにアクセスできます。
• 各イベントには、タイトル、時間、説明、および参加者が含まれます。
• 正しい MIME タイプを持つ構造化されたイベントデータが提供されます。

ツール

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

プロンプト

• analyze_schedule - カレンダーの洞察を生成します。
  • 近い将来のイベントを埋め込みリソースとして含みます。
  • LLM 分析用の構造化されたプロンプトを返します。
• [あなたが実装した他のプロンプトを追加]

📦 インストール

前提条件

• Node.js (v14 以上)
• Google Calendar API を有効にした Google Cloud プロジェクト
• OAuth 2.0 クライアント認証情報

開発環境のセットアップ

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

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

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

devbox init

devbox shell を起動します。

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

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