Google Workspace MCP サーバー

Gmail およびカレンダー API と連携するためのツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、MCP インターフェースを介してメールやカレンダーの予定をプログラムで管理できます。

特徴

Gmailツール

• list_emails : 受信トレイから最近のメールを一覧表示します（オプションでフィルタリング可能）
• search_emails : Gmail クエリ構文を使用した高度なメール検索
• send_email : CC と BCC をサポートして新しいメールを送信します
• modify_email : メールラベルを変更する（アーカイブ、ゴミ箱、既読/未読としてマーク）

カレンダーツール

• list_events : 日付範囲でフィルタリングして今後のカレンダーイベントを一覧表示します
• create_event : 参加者を指定した新しいカレンダーイベントを作成する
• update_event : 既存のカレンダーイベントを更新する
• delete_event : カレンダーイベントを削除する

前提条件

1. Node.js : Node.jsバージョン14以降をインストールします
2. Google Cloud Console のセットアップ:
   • Google Cloud Consoleに移動
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
   • Gmail API と Google カレンダー API を有効にします。
     1. 「APIとサービス」>「ライブラリ」に移動します
     2. 「Gmail API」を検索して有効にします
     3. 「Google カレンダー API」を検索して有効にします
   • OAuth 2.0 資格情報を設定します。
     1. 「APIとサービス」>「認証情報」に移動します
     2. 「認証情報を作成」>「OAuthクライアントID」をクリックします
     3. 「Webアプリケーション」を選択
     4. 「承認済みリダイレクト URI」に次の URL を含めるように設定します: http://localhost:4100/code
     5. クライアントIDとクライアントシークレットを書き留めます

セットアップ手順

Smithery経由でインストール

Smithery経由で Claude Desktop 用の gsuite-mcp を自動的にインストールするには:

手動でインストールする

1. クローンとインストール:
   git clone https://github.com/epaproditus/google-workspace-mcp-server.git cd google-workspace-mcp-server npm install
2. OAuth 資格情報の作成: ルート ディレクトリにcredentials.jsonファイルを作成します。
   { "web": { "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET", "redirect_uris": ["http://localhost:4100/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/gmail.modify
     • https://www.googleapis.com/auth/calendar
     • https://www.googleapis.com/auth/gmail.send
   • 資格情報を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-workspace": { "command": "node", "args": ["/path/to/google-workspace-server/build/index.js"], "env": { "GOOGLE_CLIENT_ID": "your_client_id", "GOOGLE_CLIENT_SECRET": "your_client_secret", "GOOGLE_REFRESH_TOKEN": "your_refresh_token" } } } }
5. ビルドと実行:
   npm run build

使用例

Gmailの操作

1. 最近のメールの一覧:
   { "maxResults": 5, "query": "is:unread" }
2. メールを検索:
   { "query": "from:example@gmail.com has:attachment", "maxResults": 10 }
3. メールを送信:
   { "to": "recipient@example.com", "subject": "Hello", "body": "Message content", "cc": "cc@example.com", "bcc": "bcc@example.com" }
4. メールアドレスの変更:
   { "id": "message_id", "addLabels": ["UNREAD"], "removeLabels": ["INBOX"] }

カレンダー操作

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": ["colleague@example.com"] }
3. 更新イベント:
   { "eventId": "event_id", "summary": "Updated Meeting Title", "location": "Virtual", "start": "2024-01-24T11:00:00Z", "end": "2024-01-24T12:00:00Z" }
4. イベントを削除:
   { "eventId": "event_id" }

トラブルシューティング

1. 認証の問題:
   • 必要なすべてのOAuthスコープが付与されていることを確認する
   • クライアントIDとシークレットが正しいことを確認する
   • リフレッシュトークンが有効かどうかを確認する
2. APIエラー:
   • API の割り当てと制限については、Google Cloud Console で確認してください。
   • プロジェクトで API が有効になっていることを確認する
   • リクエストパラメータが必要な形式と一致していることを確認する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。