Google Calendar MCP Server Xke

🚀 谷歌日历 MCP サーバー

この MCP サーバーは Google カレンダーとの統合を提供し、Claude がカレンダーイベントの表示、作成、管理を統一インターフェースを通じて行えるようにします。

✨ 主な機能

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

📦 インストール前の準備

• Node.js 16 以上
• Google Cloud プロジェクトで Calendar API を有効にする
• OAuth 2.0 の認証情報（クライアント ID とクライアントシークレット）

📚 Google Cloud の設定

1. Google Cloud Console にアクセスする
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択する
3. Google カレンダー API を有効にする
4. OAuth 2.0 の認証情報を作成する：
   • 認証情報 ページに移動する
   • 「認証情報を作成」>「OAuth クライアント ID」 をクリックする
   • アプリケーションの種類として 「デスクトップアプリ」 を選択する
   • 名前を付ける（例：「Google カレンダー MCP」）
   • 認証情報の JSON ファイルをダウンロードする
   • ダウンロードしたファイルを gcp - oauth.keys.json にリネームし、このプロジェクトのルートディレクトリに配置する

📦 インストール

1. 依存関係をインストールする：

   npm install
   

2. TypeScript コードをビルドする：

   npm run build
   

3. Claude MCP の設定ファイルを更新してこのサーバーを追加する：

   • cline_mcp_settings.json に以下の内容を追加する：

   "github.com/pashpashpash/google - calendar - mcp": {
     "command": "node",
     "args": ["C:/Users/ralph/Documents/Cline/MCP/google - calendar - mcp/build/index.js"],
     "env": {},
     "disabled": false,
     "autoApprove": []
   }
   

🔧 認証フロー

初めて Google カレンダー MCP サーバーを使用するとき、以下のように動作します：

1. 認証トークンがないことを検出する
2. 認証サーバーを起動する（ポート 3000 - 3004）
3. ブラウザウィンドウを開いて OAuth 認証を行う
4. 認証トークンを安全に保存する
5. 認証サーバーを閉じて通常の動作を続ける

認証トークンは .gcp - saved - tokens.json に保存され、自動的に更新されます。

💻 使用例

基本的な使用法

カレンダーを一覧表示する

list - calendars

イベントを一覧表示する

list - events
calendarId: "primary"
timeMin: "2023 - 01 - 01T00:00:00Z"
timeMax: "2023 - 12 - 31T23:59:59Z"
maxResults: 10

新しいイベントを作成する

create - event
calendarId: "primary"
summary: "チーム会議"
location: "会議室 B"
description: "毎週のチーム同期会議"
startDateTime: "2023 - 06 - 15T10:00:00"
endDateTime: "2023 - 06 - 15T11:00:00"

既存のイベントを更新する

update - event
eventID: "eventId123"
calendarId: "primary"
summary: "更新されたチーム会議"
description: "更新された会議の説明"

イベントを削除する

delete - event
eventID: "eventId123"
calendarId: "primary"

📚 トラブルシューティング

• Google カレンダーに接続できない場合は、ネットワーク接続と API の権限を確認する
• gcp - oauth.keys.json ファイルが存在し、正しく設定されていることを確認する