mcpField
G
Google Workspace MCP Server

Google Workspace MCP Server

ローカル
workspacemcp.com生産性3.4k1 日前に更新
ドキュメントリポジトリ公式サイト

Google Workspace MCP Server について

Google Workspace MCP Server は、Gmail、Drive、Calendar、Docs などのサービスを AI アシスタントや開発ツールに接続します。サービス別のツールに加え、ツール階層の設定、OAuth 認証、CLI を備えています。

主な機能

  1. 01Workspace サービス用ツール
  2. 02ツール階層と権限の設定
  3. 03読み取り専用モード
  4. 04OAuth 2.1 のマルチユーザー認証
  5. 05ツールの一覧表示と呼び出し用 CLI
  6. 06HTTP と stdio のトランスポート

活用シーン

  1. 01Gmail メッセージの検索と管理
  2. 02Calendar イベントの作成や更新
  3. 03AI クライアントから Docs や Sheets を編集
  4. 04スクリプトから Workspace ツールを実行

MCP 対応

Google Workspace の操作をツールとして MCP クライアントに公開し、streamable HTTP または stdio で接続します。

#ai#mcp#gmail#google-calendar#google-workspace#llm#llm-tools#mcp-server

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "google_workspace_mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ]
    }
  }
}
起動コマンドuvx workspace-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiworkspace-mcp2.2.1

ツール

120

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
service_namestringはい
user_google_emailstringいいえ

詳細

翻訳後に原文が更新されています。最新の内容は原文をご確認ください。

Google Workspace MCP サーバー README の画像

ライセンス：MIT Python 3.10+ PyPI PyPI ダウンロード数 MCP Toplist ウェブサイト

readme-banner

MCP クライアント、AI アシスタント、開発者ツールを通じて、Google Calendar、Drive、Gmail、Docs、Sheets、Slides、Forms、Tasks、Contacts、Chat を自然言語で全面的に操作できます。 Claude Code や Codex などのツールで使える、機能豊富な CLI とコードモードを搭載しています！

Google Workspace MCP サーバーの中で最も機能が充実しており、他とは一線を画します。マルチユーザー対応、詳細な編集ツール、既存のあらゆる Workspace AI 統合の中で最も幅広いカバー範囲を備え、Google 独自のツールや Claude、ChatGPT に組み込まれた統合機能では到底できないことを実現できます。

ネイティブの OAuth 2.1、ステートレスなデプロイ機能、外部認証サーバーおよびゲートウェイのパススルー認証に対応しているため、組織全体で一元的かつ安全にホストできる唯一の Workspace MCP でもあります！

すべての無料 Google アカウントと Google Workspace プランに対応し、Chat や Spaces などのアプリも利用できます。
マネージドクラウドインスタンスにご興味がありますか？ご利用いただけます（月額 5 ドルから）。

ドキュメントを読む クイックスタートガイド

動作をご覧ください：

できること

Workspace MCP は、AI アシスタントを Google Workspace の主要 12 サービスすべてに接続します。単一の MCP サーバーで 120 以上のツールを利用でき、OAuth 2.1 によるマルチユーザー認証、段階的に利用できる 3 つのツール層、読み取り専用モード、フル機能の CLI、ステートレスなコンテナデプロイに対応しています。レガシークライアント向けには stdio でローカル実行でき、最新の MCP 仕様を完全に実装したストリーミング可能な HTTP でリモート実行できます。

この README では、利用を開始するために必要な情報を簡潔に説明しています。詳しいドキュメントはウェブサイトをご覧ください。

移動先内容
クイック スタートGoogle Cloud の設定、認証情報、スクリーンショット付きのクライアント接続手順
完全な ドキュメントすべてのツール、パラメーター、認証モード
高度な デプロイリバースプロキシと nginx の設定、オリジン検証、認証情報ストアのバックエンド（GCS/CMEK）、信頼できるゲートウェイの ID、環境変数の完全なリファレンス
クライアント 設定 ガイドClaude Desktop/web Connectors、ChatGPT Developer Mode など
FAQ と トラブルシューティングGoogle API の有効化、OAuth エラー、リダイレクト URI、Google Chat の設定、クライアント固有の問題

セキュリティとコンプライアンス

セキュリティチーム向け

デフォルトでは、このサーバーは認証済みユーザーに代わって、ユーザー自身の OAuth クライアント認証情報を使い、Google の API 以外にデータを送信しません。利用状況の報告、分析、ライセンスサーバー、SaaS への依存はありません。例外は、独自の利用状況を計測するための任意の OTel サポートです。

  • 完全なオープンソース — このリポジトリ内のすべての行を監査できます
  • OAuth クライアントも GCP プロジェクトも独自に管理 — 認証情報が環境外に出ることはなく、スコープも管理できます
  • ネットワークを管理 — リバースプロキシの背後や自身の VPC 内など、任意の環境にデプロイできます
  • ステートレスモード — 制約の厳しいコンテナ環境でも、ディスクへの書き込みは一切ありません
  • 機密パスのブロック — ローカルファイルの読み取り先は、デフォルトで管理対象の添付ファイルディレクトリに制限されます。また、ALLOWED_FILE_DIRS を広げた場合でも、validate_file_path() は .env* ファイルや ~/.ssh/、~/.aws/ など一般的なホームディレクトリ内の認証情報ストアを引き続きブロックします

依存関係ツリー全体は pyproject.toml に記載され、uv.lock でバージョンが固定されています。

法務・調達チーム向け

このプロジェクトはMITライセンスです。「オープンコア」でも「ソースコード公開」でも「CLA への同意を条件とする無料利用」でもありません。デュアルライセンスはなく、商用プランで機能を制限することもなく、コントリビューターライセンス契約もありません。

  • 制限なく商用利用可能 — 製品の開発、サービスの販売、社内デプロイが可能です
  • フォーク、組み込み、再配布が可能 — MIT ライセンスで必要なのは著作権表示のみです
  • CLA なし — コントリビューションには MIT ライセンスが適用されます
  • 開示が必要な組み込みテレメトリーなし — 任意のトレーシングは、設定しない限り無効です
  • ネットワーク上の依存なし — 設定していないエンドポイントにサーバーが接続することはありません
  • 標準的な依存関係ライセンス — 依存関係全体で MIT、Apache 2.0、BSD を採用しており、コピーレフトや AGPL はありません
## サービス
📧
Gmail
15 個のツール — 検索、送信、下書き、
ラベル、フィルタ、添付ファイル
📁
Drive
16 個のツール — 検索、作成、共有、
Office ファイルのインポート
📅
Calendar
7 個のツール — 予定、空き状況、
不在時の予定、集中時間
📝
Docs
19 個のツール — 編集、スタイル、表、
タブ、コメント、エクスポート
📊
Sheets
14 個のツール — 範囲、表、
書式設定、条件付きルール
🖼️
Slides
7 個のツール — 作成、一括更新、
サムネイル、コメント
📋
Forms
6 個のツール — フォームの作成、公開、
回答の閲覧
✅
Tasks
6 個のツール — 階層構造に対応した
タスクとリスト
👤
Contacts
8 個のツール — 人物、グループ、
一括操作
💬
Chat
6 個のツール — スペース、メッセージ、
検索、リアクション
🔍
カスタム検索
2 個のツール — プログラム可能な
ウェブ検索
⚡
Apps Script
15 個のツール — スクリプトの作成、デプロイ、
実行、デバッグ

各ページには、すべてのツールとそのティア、パラメーター、必須スコープ、プロンプトの例が掲載されています。完全なリファレンスでは、12 種類すべてをまとめて確認できます。

💬 Google Chat の利用には、Chat アプリの初回設定と Workspace アカウントが必要です。詳しくはChat セットアップ FAQをご覧ください。

クイックスタート

認証情報を設定 → 起動コマンドを選択 → クライアントを接続します。スクリーンショット付きの詳しい手順は、**workspacemcp.com/quick-start**をご覧ください。

利用するサービスの Google API を有効にしたプロジェクトで、Google Cloud Consoleから OAuth クライアントを作成する必要があります。ドキュメントには、すべての API を有効にするワンクリックリンクと、すべての API をまとめて有効にする単一の gcloud services enable コマンドが用意されています。また、クイックスタートガイドでは、セットアップ全体を約 5 分で完了する手順を紹介しています。

機密クライアント

# 1. Credentials
export GOOGLE_OAUTH_CLIENT_ID="..."
export GOOGLE_OAUTH_CLIENT_SECRET="..."

# 2. Launch - pick a tier
uvx workspace-mcp --tool-tier core       # essential tools
uvx workspace-mcp --tool-tier extended   # core + management ops
uvx workspace-mcp --tool-tier complete   # everything

# Or cherry-pick services
uvx workspace-mcp --tools gmail drive calendar

OAuth 2.1（PKCE）

# 1. Credentials - MCP clients connect with PKCE and no
#    secret, but Google still requires one server-side
export MCP_ENABLE_OAUTH21=true
export GOOGLE_OAUTH_CLIENT_ID="..."
export GOOGLE_OAUTH_CLIENT_SECRET="..."
#    Alternatively, point GOOGLE_CLIENT_SECRET_PATH at a client_secret.json
#    that contains the client id and secret (env vars take precedence).
export WORKSPACE_MCP_PORT=8000
export GOOGLE_OAUTH_REDIRECT_URI="http://localhost:${WORKSPACE_MCP_PORT}/oauth2callback"
export OAUTHLIB_INSECURE_TRANSPORT=1

# 2. Launch - OAuth 2.1 requires HTTP transport
uvx workspace-mcp --transport streamable-http --tool-tier core

ツールの階層を使うと、コンテキストウィンドウを軽く保てます。coreは基本セット、extendedは管理操作を追加し、completeはすべてを読み込みます。--tools <service> ...、--read-only、サービスごとの--permissionsと組み合わせたり、--disabled-tools <name> ...で個別のツールを除外したりできます。詳しくはサーバーモードのドキュメントをご覧ください。

クライアントを接続する

Claude Desktop、Web、モバイル - サーバーを HTTP モードで実行し、コネクターとして追加します（設定 → コネクター → カスタムコネクターを追加）。こちらを推奨します。コネクターガイドでは、スクリーンショット付きで手順を説明しています。コネクターに対応していないクライアント向けには、従来の stdio 設定も引き続き利用できます。FAQをご覧ください。

Claude Code

# Start the server in HTTP mode, then:
claude mcp add --transport http workspace-mcp http://localhost:8000/mcp

# Optional: install the bundled skill for better Workspace tool routing
ln -s "$(pwd)/skills/managing-google-workspace" ~/.claude/skills/managing-google-workspace

ChatGPT - ChatGPT ガイドに従って、開発者モード経由で接続します。

VS Code、LM Studio、Open WebUI など - すべての MCP クライアントは、ストリーム可能な HTTP（推奨）または stdio 経由で動作します。クライアントごとの手順は、ガイドとFAQをご覧ください。

CLI

workspace-cliは、暗号化されたディスクベースの OAuth トークンキャッシュを使い、実行中のサーバーに対するツールの一覧表示や呼び出しを行います。一度認証すれば、あとは何度でもスクリプトを実行できます。

uv run workspace-cli list
uv run workspace-cli call search_gmail_messages query="is:unread" max_results=5

このリポジトリからuv tool install .を実行してグローバルにインストールします。⚠️ uvx workspace-cliは使用しないでください。放棄された PyPI パッケージがその名前を占有しています。

デプロイと高度な設定

本番環境で実行するために必要な情報は、2 か所にまとまっています。ドキュメントでは、認証モードとサーバー設定について説明しています。

高度なデプロイガイド では、セルフホストの詳細を説明しています。WORKSPACE_EXTERNAL_URL を使用したリバースプロキシの設定（nginx の Origin: null 同意に関する回避策、WORKSPACE_MCP_ALLOW_NULL_ORIGIN_CONSENT というエスケープハッチ、Referrer-Policy の落とし穴を含む）、オリジン検証と VS Code webview の許可リスト登録、資格情報ストアのバックエンド（ローカルディレクトリ、または CMEK 適用を伴う GCS）、そして 環境変数の完全なリファレンス を扱っています。

本番環境のチューニングはすべて環境変数で行います。以下の名前はそれぞれのリファレンス項目にリンクしています。

ダウンロードの場合、水平スケーリングやスケール・トゥ・ゼロの HTTP デプロイメント（Cloud Run、Kubernetes）では、添付ファイルをインスタンスローカルのディスクではなく Google Cloud Storage にステージングできます。インスタンスローカルのディスクでは、/attachments/{id} URL が別のインスタンスに到達する可能性があります。gcs エクストラをインストールし、WORKSPACE_MCP_FILES_GCS_BUCKET にバケット名を設定してください。オブジェクトは WORKSPACE_MCP_FILES_GCS_PREFIX（デフォルトは attachments）の下に書き込まれ、1 時間有効な V4 署名付き URL として払い出されます。クライアントはこれを GCS から直接取得します。これにより、ステートレスモードでもインラインファイルではなくダウンロード URL を返せるようになります。stdio はクライアントがローカルファイルパスを直接読み取るため、この設定を無視します。ランタイムサービスアカウントには、バケットに対するオブジェクトの読み取りと書き込みのアクセス権、すなわち roles/storage.objectUser、または roles/storage.objectCreator と roles/storage.objectViewer が必要です。また、エクスポートされた秘密鍵がない場合は、IAM を介して URL に署名できるように、自身に対する roles/iam.serviceAccountTokenCreator も必要です。読み取りアクセスは省略できません。署名付き URL は署名者の権限を引き継ぐため、storage.objects.get がないと、アップロードと署名の両方は成功するものの、クライアントのダウンロードが 403 で失敗します。オブジェクトはサーバーによって削除されないため、数時間後に削除するバケットのライフサイクルルールを追加してください。

セキュリティのベストプラクティス

デフォルトでは、このサーバーはユーザー自身の OAuth クライアント認証情報を使用して、Google の API 以外にデータを送信しません。使用状況の報告、分析、ライセンスサーバー、SaaS への依存はありません。MIT ライセンスで、CLA やデュアルライセンスはなく、依存関係チェーンにコピーレフトもありません。スコープの最小化、機密パスのブロック、ステートレスモードなど、セキュリティ対策の全容は workspacemcp.com に記載されています。

LLM をメールに接続する前に、心に留めておきたいことをいくつか紹介します。

  • プロンプトインジェクションは現実の脅威です。 メール、ドキュメント、イベントには、隠された指示が含まれていることがあります。信頼できるデータだけを LLM に接続し、有効にする書き込みツールは慎重に選んでください。
  • .env、client_secret.json、.credentials/ をソース管理にコミットしないでください。
  • ローカルファイルの読み取りは、管理対象の添付ファイルディレクトリ内に制限されています。 クライアントとそのデータソースを信頼できる場合に限り、ALLOWED_FILE_DIRS で範囲を広げてください。.env*、~/.ssh/、~/.aws/ などのパスは常にブロックされます。
  • 本番環境へのデプロイでは、HTTPS と OAuth 2.1 を使用してください。

開発

uv sync --group dev    # install deps
uv run ruff check .    # lint
uv run pytest          # test

単一ファイルのサービスモジュールは g<service>/ にあり、ツールは @server.tool デコレーターで登録され、階層は core/tool_tiers.yaml で定義されています。プルリクエストを歓迎します。

ライセンス

MIT — LICENSE をご覧ください。ライセンスは 21 行で、その内容は明快です。

検証： MCP Badge

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。