Gcal MCP Server

🚀 Google Calendar MCP サーバー

このサーバーは、標準化されたインターフェースを通じて Google Calendar との統合を実現する Model Context Protocol (MCP) サーバーです。LLM アプリケーションがカレンダーイベントを管理できるようにします。

✨ 主な機能

• 利用可能なカレンダーを一覧表示する
• カレンダーからイベントを一覧表示する
• 新しいカレンダーイベントを作成する
• 既存のイベントを更新する
• イベントを削除する

📚 詳細ドキュメント

Google Cloud の設定

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. Google Calendar API を有効にします。
4. OAuth 2.0 クレデンシャルを作成します：
   • クレデンシャル に移動します。
   • 「クレデンシャルを作成」>「OAuth クライアント ID」 をクリックします。
   • アプリケーションがアクセスするデータの種類として 「ユーザーデータ」 を選択します。
   • アプリケーション名と連絡先情報を追加します。
   • 以下のスコープを追加します（オプション）：
     • https://www.googleapis.com/auth/calendar.events
   • アプリケーションの種類として 「デスクトップアプリ」 を選択します。
   • OAuth 同意画面 の下で、テストユーザーとしてあなたのメールアドレスを追加します。
     • 注意： テストユーザーの反映に数分かかる場合があります。

📦 インストール

手順

1. リポジトリをクローンします：

   git clone <repository-url>
   cd gcal-mcp-server
   

2. 仮想環境を作成します：

   uv venv
   # Mac/Linux の場合
   source .venv/bin/activate
   # Windows の場合
   .venv\Scripts\activate
   # 編集モードでパッケージをインストールします
   uv pip install -e .
   

💻 使用例

基本的な使用法

1. 必要な .env ファイルの環境変数を設定します。
2. サーバーを起動します：

   uv run client.py