google-workspace-mcp

Google Workspace MCP

Admin SDK、Gmail、Calendar、Drive API を通じて Google Workspace リソースを管理するためのツールを提供する、Google Workspace 用 Model Context Protocol（MCP）サーバーです。

前提条件

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 Admin Console で、必要な OAuth スコープをサービスアカウントに付与します

環境変数

アプリケーションを実行するには、次の環境変数を設定する必要があります。

変数	説明
GOOGLE_SERVICE_ACCOUNT	サービスアカウントの JSON キーファイルへのパス
GOOGLE_ADMIN_EMAIL	偽装する Google Workspace 管理者ユーザーのメールアドレス

トランスポート（任意）

デフォルトでは、サーバーは stdio 経由で実行されます。代わりに Streamable HTTP トランスポートを使用するには、MCP_TRANSPORT=http を設定してください。

変数	説明
MCP_TRANSPORT	使用するトランスポート：stdio（デフォルト）または http
MCP_HTTP_ADDR	HTTP トランスポートのリッスンアドレス（デフォルトは :8080）
MCP_AUTH_TOKEN	設定すると、HTTP リクエストに Authorization: Bearer <token> を含める必要があります

MCP_TRANSPORT=http MCP_HTTP_ADDR=:8080 MCP_AUTH_TOKEN=your-secret-token google-workspace-mcp

クライアントは http://<host>:8080/ に接続し、次のようにベアラートークンを送信します。

Authorization: Bearer your-secret-token

使用方法

ビルド

make build

設定

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

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

利用可能なツール

ディレクトリツール

• directory_users - Google Workspace ディレクトリ内のすべてのユーザーを一覧表示します
• create_user - Google Workspace に新しいユーザーを作成します
• get_user - 特定のユーザーの詳細情報を取得します
• update_user - 既存のユーザーの名前、パスワード、または組織部門を更新します
• delete_user - Google Workspace からユーザーを削除します
• suspend_user - ユーザーアカウントを一時停止または復元します

グループツール

• list_groups - ドメイン内のグループを一覧表示します
• get_group - 特定のグループの詳細情報を取得します
• create_group - Google Workspace に新しいグループを作成します
• delete_group - Google Workspace からグループを削除します
• list_group_members - グループのメンバーを一覧表示します
• add_group_member - グループにメンバーを追加します
• remove_group_member - グループからメンバーを削除します

Gmail ツール

• list_gmail - 最近の Gmail メッセージを一覧表示します（Gmail API へのアクセスが必要です）

Calendar ツール

• list_calendar_events - ユーザーの今後のカレンダー予定を一覧表示します（Calendar API へのアクセスが必要です）
• create_calendar_event - 新しいカレンダー予定を作成します（Calendar API へのアクセスが必要です）

Drive ツール

• list_drive_files - Google Drive 内のファイルを一覧表示します（Drive API へのアクセスが必要です）
• search_drive_files - Google Drive 内のファイルを検索します（Drive API へのアクセスが必要です）
• get_drive_file - 特定の Drive ファイルの詳細情報を取得します（Drive API へのアクセスが必要です）
• create_drive_folder - Google Drive に新しいフォルダーを作成します（Drive API へのアクセスが必要です）
• upload_drive_file - ファイルを Google Drive にアップロードします（Drive API へのアクセスが必要です）
• share_drive_file - Drive ファイルを別のユーザーと共有します（Drive API へのアクセスが必要です）

Sheets ツール

• list_spreadsheets - Drive 内の Google Sheets スプレッドシートを一覧表示します（Sheets API へのアクセスが必要です）
• get_spreadsheet - シートを含む、スプレッドシートの詳細情報を取得します（Sheets API へのアクセスが必要です）
• read_sheet_range - スプレッドシート内の指定範囲からデータを読み取ります（Sheets API へのアクセスが必要です）
• write_sheet_range - スプレッドシート内の指定範囲にデータを書き込みます（Sheets API へのアクセスが必要です）
• append_sheet_rows - スプレッドシートにデータ行を追加します（Sheets API へのアクセスが必要です）
• create_spreadsheet - 新しい Google Sheets スプレッドシートを作成します（Sheets API へのアクセスが必要です）

Tasks ツール

• list_task_lists - ユーザーの Google Tasks のタスクリストをすべて一覧表示します（Tasks API へのアクセスが必要です）
• list_tasks - 指定したタスクリスト内のタスクをすべて一覧表示します（Tasks API へのアクセスが必要です）
• create_task - タスクリストに新しいタスクを作成します（Tasks API へのアクセスが必要です）
• update_task - 既存のタスクを更新します（Tasks API へのアクセスが必要です）
• delete_task - タスクリストからタスクを削除します（Tasks API へのアクセスが必要です）
• complete_task - タスクを完了としてマークします（Tasks API へのアクセスが必要です）

必要な OAuth スコープ

サービスアカウントのドメイン全体の委任を設定する際は、次の OAuth スコープを付与してください。

• https://www.googleapis.com/auth/admin.directory.user - ディレクトリのユーザー情報へのアクセスと管理に使用します
• https://www.googleapis.com/auth/admin.directory.group - グループの管理に使用します
• https://www.googleapis.com/auth/admin.directory.group.member - グループメンバーの管理に使用します
• https://www.googleapis.com/auth/gmail.readonly - Gmail メッセージの読み取りに使用します
• https://www.googleapis.com/auth/calendar - カレンダーイベントの読み書きに使用します
• https://www.googleapis.com/auth/drive - Google Drive へのフルアクセス（ファイルの読み取り、書き込み、管理）に使用します
• https://www.googleapis.com/auth/spreadsheets - Google Sheets スプレッドシートの読み書きに使用します
• https://www.googleapis.com/auth/tasks - Google Tasks の読み書きに使用します