Google Workspace MCP

🚀 Google Workspace MCP

Google Workspace MCPは、Google Workspaceリソースを管理するためのModel Context Protocol (MCP)サーバーです。Admin SDKを通じて便利なツールを提供します。

🚀 クイックスタート

✨ 主な機能

Google Workspace MCPは、Google Workspaceのリソース管理を容易にするためのサーバーで、Admin SDKを介してさまざまなツールを提供します。

📦 インストール

前提条件

1. Admin SDK APIを有効にしたGoogle Cloud Platformプロジェクト
2. 適切な権限を持つサービスアカウント
3. 代入に使用するGoogle Workspace管理者ユーザーのメールアドレス

サービスアカウントの設定

1. Google Cloud Consoleでサービスアカウントを作成します。
2. そのサービスアカウントにGoogle Workspace Admin SDKを使用するための適切な権限を付与します。
3. サービスアカウントのJSONキーファイルを作成してダウンロードします。
4. サービスアカウントのドメイン範囲の委任機能を有効にします。
5. Google Workspace管理コンソールでサービスアカウントに必要なOAuthスコープを付与します。

環境変数

アプリケーションには以下の環境変数が必要です。

💻 使用例

基本的な使用法

ビルド

make build

設定例

{
  "mcpServers": {
     "googleworkspace-mcp": {
      "command": "/go/bin/google-workspace-mcp",
      "args": [],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT": "test.json",
        "GOOGLE_ADMIN_EMAIL": "admin@yourdomain.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

⚠️ 重要提示

サービスアカウントがGoogle Cloud Consoleで必要なAPIアクセス権限（Admin SDK API、Gmail API、Calendar API）を有効にしていることを確認してください。

利用可能なツール

• directory_users - Google Workspaceディレクトリ内のすべてのユーザーをリストします。
• create_user - 新しいGoogle Workspaceユーザーを作成します。
• list_gmail - 最近のGmail情報をリストします（Gmail APIアクセス権限が必要）。
• list_calendar_events - 特定のユーザーの今後のカレンダーイベントをリストします（Calendar APIアクセス権限が必要）。
• create_calendar_event - 新しいカレンダーイベントを作成します（Calendar APIアクセス権限が必要）。

必要なOAuthスコープ

サービスアカウントのドメイン範囲の委任を設定する際に、以下のOAuthスコープを付与してください。

• https://www.googleapis.com/auth/admin.directory.user - ディレクトリユーザー情報のアクセスと管理に使用します。
• https://www.googleapis.com/auth/gmail.readonly - Gmail情報の読み取りに使用します。
• https://www.googleapis.com/auth/calendar - カレンダーイベントの読み取りと書き込みに使用します。