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: 予定の削除

必要条件

Node.js: Node.js 20 以上をインストール
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 をメモ

セットアップ手順

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

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

認証情報の設定:

# 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"
  }
}

リフレッシュトークンの取得:
```
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に保存されます
- コンソールにリフレッシュトークンが表示されます

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"
      }
    }
  }
}

ビルドと実行:
```
npm run build
```
デプロイ設定の追加 (.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 操作

最近のメール一覧:

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

メール検索:

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

メール送信:

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

メールラベルの変更:

{
  "id": "message_id",
  "addLabels": ["UNREAD"],
  "removeLabels": ["INBOX"]
}

カレンダー操作

予定一覧:

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

予定作成:

{
  "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]"]
}

予定更新:

{
  "eventId": "event_id",
  "summary": "Updated Meeting Title",
  "location": "Virtual",
  "start": "2024-01-24T11:00:00Z",
  "end": "2024-01-24T12:00:00Z"
}

予定削除:
```
{
  "eventId": "event_id"
}
```

トラブルシューティング

認証の問題:
- 必要な OAuth スコープが付与されているか確認
- Client ID と Secret が正しいか確認
- リフレッシュトークンが有効か確認
API エラー:
- Google Cloud Console で API クォータと制限を確認
- プロジェクトで API が有効化されているか確認
- リクエストパラメータが正しい形式か確認

ライセンス

MIT