Google Calendar MCP Server

Google Calendar MCP Server

このリポジトリでは、Google Calendar API と連携する Model Context Protocol（MCP）サーバーを提供しています。カレンダーの予定の一覧表示、作成、削除、更新ができます。このサーバーは、MCP クライアントとして Anthropic の Claude Desktop で動作するように設計されています。

🚀 機能

• Google Calendar を操作：予定の一覧表示、追加、削除、更新
• MCP を介した Claude Desktop とのシームレスな連携

---

🧰 前提条件

• Google アカウント
• Anthropic Claude Desktop

---

📦 インストール

1. UV Package Manager をインストールします： 公式の UV インストールガイドの手順に従ってください。

2. リポジトリをクローンして環境を設定します：

   git clone https://github.com/rsc1102/Google_Calendar_MCP.git
   cd Google_Calendar_MCP
   uv sync
   

3. Google Cloud の認証情報を作成します：

   • Google Cloud Consoleにアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • Google Calendar API を有効にします。
   • APIs & Services > Credentials に移動します。
   • Create Credentials > OAuth Client ID をクリックします：
     • アプリケーションの種類として Desktop app を選択します。
     • 生成された credentials.json ファイルをダウンロードします。
     • credentials.json を Google_Calendar_MCP ディレクトリ内に配置します。

---

🔌 Claude Desktop との連携

1. 設定ファイルを確認します： システム上の claude_desktop_config.json ファイルを開きます：

   Linux/macOS：

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

   Windows (PowerShell)：

   code $env:AppData\Claude\claude_desktop_config.json
   

2. MCP サーバーの設定を追加します： mcpServers セクションに以下を追加します：

   {
       "mcpServers": {
           "calendar": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/ABSOLUTE/PATH/TO/PARENT/FOLDER/Google_Calendar_MCP",
                   "run",
                   "calendar_mcp.py"
               ]
           }
       }
   }
   

3. Claude Desktop を再起動します。

4. Claude Desktop で新しいプロジェクトを作成します。

5. タイムゾーンを設定します： プロジェクトのナレッジセクションで、IANA タイムゾーン形式を使ってローカルのタイムゾーンを定義します（例：timeZone="America/New_York"）。

6. チャットを開始します： Claude とのやり取りを開始して、Google Calendar の予定を管理します。
   注： このサーバーを初めて使用するときは、Google から認証とカレンダーへのアクセス許可を求められます。

---

🎬 動作例

https://github.com/user-attachments/assets/75da4943-15c4-4ec2-bc5d-af4af3509031

---

📬 サポート

問題や質問がある場合は、このリポジトリで issue を作成してください。