Google Calendar MCP

🚀 Google カレンダー MCP サーバー

このリポジトリは、Google Calendar API と統合されたモデルコンテキストプロトコル（MCP）サーバーを提供します。ユーザーはカレンダーイベントの一覧表示、追加、削除、更新が可能です。このサーバーは、Anthropic の Claude デスクトップ版を MCP クライアントとして使用するように設計されています。

🚀 クイックスタート

このサーバーを使用することで、Google カレンダーとのやり取りが可能になり、Claude デスクトップ版ともシームレスに統合できます。以下に、セットアップ手順を説明します。

✨ 主な機能

• Google カレンダーとのやり取り：イベントの一覧表示、追加、削除、更新
• Claude デスクトップ版とのシームレスな統合

🧰 事前準備

• Google アカウント
• Anthropic Claude デスクトップ版

📦 インストール

1. UV パッケージマネージャーのインストール： 公式 UV インストールガイドの手順に従ってください。

2. リポジトリのクローンと環境の設定：

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

3. Google Cloud の認証情報の作成：

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

🔌 Claude デスクトップ版への統合

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 デスクトップ版を再起動します。

4. Claude デスクトップ版で新しいプロジェクトを作成します。

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

6. チャットの開始： Claude との対話を開始して、Google カレンダーのイベントを管理します。注意： サーバーを初めて使用する際、Google から認証とカレンダーへのアクセス許可を求められます。

🎬 実際の操作デモ

動画リンク

📬 サポート

ご質問やヘルプが必要な場合は、このリポジトリでイシューを開いてください。