Google Calendar MCP Server

Google Calendar MCP サーバー

Google Calendar API と連携するためのツールを提供する、Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、MCP インターフェースを通じてプログラムからカレンダーの予定を管理できます。

機能

カレンダーツール

• list_events：日付範囲で絞り込んで、今後のカレンダーの予定を一覧表示します
• create_event：参加者を指定して、新しいカレンダーの予定を作成します
• update_event：既存のカレンダーの予定を更新します
• delete_event：カレンダーの予定を削除します

前提条件

1. Node.js：バージョン 14 以上の Node.js をインストールします
2. Google Cloud Console の設定：
   • Google Cloud Console にアクセスします
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
   • Google Calendar API を有効にします：
     1. 「APIs & Services」>「Library」に移動します
     2. 「Google Calendar API」を検索して有効にします
   • OAuth 2.0 の認証情報を設定します：
     1. 「APIs & Services」>「Credentials」に移動します
     2. 「Create Credentials」>「OAuth client ID」をクリックします
     3. 「Web application」を選択します
     4. 「Authorized redirect URIs」に http://localhost:3000/code を追加します
     5. Client ID と Client Secret を控えておきます

セットアップ手順

1. クローンしてインストール：

   git clone https://github.com/yourusername/google-calendar-mcp-server.git
   cd google-calendar-mcp-server
   npm install
   

2. OAuth 認証情報を作成： ルートディレクトリに credentials.json ファイルを作成します：

   {
       "web": {
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET",
           "redirect_uris": ["http://localhost:3000/code"],
           "auth_uri": "https://accounts.google.com/o/oauth2/auth",
           "token_uri": "https://oauth2.googleapis.com/token"
       }
   }
   

3. リフレッシュトークンを取得：

   node get-refresh-token.js
   

   次の処理が行われます：

   • Google OAuth 認証のためにブラウザーが開きます
   • 次の権限が要求されます：
     • https://www.googleapis.com/auth/calendar
   • 認証情報が token.json に保存されます
   • リフレッシュトークンがコンソールに表示されます

4. MCP 設定： MCP の設定ファイルにサーバー設定を追加します：

   • VSCode Claude 拡張機能の場合：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Claude デスクトップアプリの場合：~/Library/Application Support/Claude/claude_desktop_config.json

   mcpServers オブジェクトに次の内容を追加します：

   {
     "mcpServers": {
       "google-calendar": {
         "command": "node",
         "args": ["/path/to/google-calendar-server/build/index.js"],
         "env": {
           "GOOGLE_ACCESS_TOKEN": "your_access_token",
         }
       }
     }
   }
   

5. ビルドして実行：

   npm run build
   

使用例

カレンダー操作

1. 予定の一覧表示：

   {
     "maxResults": 10,
     "timeMin": "2024-01-01T00:00:00Z",
     "timeMax": "2024-12-31T23:59:59Z"
   }
   

2. 予定の作成：

   {
     "summary": "Team Meeting",
     "location": "Conference Room",
     "description": "Weekly sync-up",
     "start": "2024-01-24T10:00:00Z",
     "end": "2024-01-24T11:00:00Z",
     "attendees": ["[email protected]"]
   }
   

3. 予定の更新：

   {
     "eventId": "event_id",
     "summary": "Updated Meeting",
     "location": "Virtual",
     "description": "Rescheduled weekly sync-up",
     "start": "2024-01-25T10:00:00Z",
     "end": "2024-01-25T11:00:00Z"
   }
   

4. 予定の削除：

   {
     "eventId": "event_id"
   }
   

ライセンス

MIT