Google Workspace MCP Server

Google Workspace MCP Server

このプロジェクトは以下のリポジトリをベースに作成しています： epaproditus/google-workspace-mcp-server

Google Workspace の機能（カレンダー、メール）を 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 20 以上をインストール
2. Google Cloud Console 設定:
   • Google Cloud Consoleにアクセス
   • 新規プロジェクトの作成または既存プロジェクトの選択
   • Gmail API と Google Calendar API の有効化:
     1. "APIs & Services" > "Library"に移動
     2. "Gmail API"を検索して有効化
     3. "Google Calendar API"を検索して有効化
   • OAuth 2.0 認証情報の設定:
     1. "APIs & Services" > "Credentials"に移動
     2. "Create Credentials" > "OAuth client ID"をクリック
     3. "Desktop application"を選択
     4. "Authorized redirect URIs"にhttp://localhost:4100/codeを追加
     5. Client ID と Client Secret をメモ

セットアップ手順

1. リポジトリのクローンとインストール:

   git clone https://github.com/Yulikepython/gogole-workspace-mcp-server-by-itc.git
   cd google-workspace-mcp-server-by-itc
   npm install
   

2. 認証情報の設定:

   # credentials.json.exampleをコピー
   cp credentials.json.example credentials.json
   

   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
   

6. デプロイ設定の追加 (.env):

   deploy スクリプトを使用するには .env ファイルが必要です。

   cp .env.example .env
   

   .env に以下の環境変数を設定してください:

   SSH_USER=your_ssh_user
   SSH_HOST=your.ssh.host
   SSH_PATH=/your/deploy/path
   

npm scripts

コマンド	説明
npm run build	バンドルを作成し、実行可能権限を付与
npm run start	ローカルでビルド＆実行
npm run clean	ビルド成果物を削除
npm run deploy	ビルド後、本番環境にファイルをデプロイ
npm run logs	本番環境のアプリケーションログをリアルタイムで表示

使用例

Gmail 操作

1. 最近のメール一覧:

   {
     "maxResults": 5,
     "query": "is:unread"
   }
   

2. メール検索:

   {
     "query": "from:[email protected] has:attachment",
     "maxResults": 10
   }
   

3. メール送信:

   {
     "to": "[email protected]",
     "subject": "Hello",
     "body": "Message content",
     "cc": "[email protected]",
     "bcc": "[email protected]"
   }
   

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": ["[email protected]"]
   }
   

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 スコープが付与されているか確認
   • Client ID と Secret が正しいか確認
   • リフレッシュトークンが有効か確認

2. API エラー:

   • Google Cloud Console で API クォータと制限を確認
   • プロジェクトで API が有効化されているか確認
   • リクエストパラメータが正しい形式か確認

ライセンス

MIT