google-workspace-mcp

Google Workspace（Gmail、Google Calendar、Google Drive、Google Sheets、Google Docs）上で動作する、5つの独立したリモートMCPサーバーのセットです。

ステータス: pre-alpha。 このプロジェクトは活発に開発中です。公開インターフェースと設定は最初の安定版リリースまで変更される可能性があります。

サーバーは意図的に分離されています。クライアントまたはプロジェクトは、必要なサービスだけを組み込み、そのサービス専用に有効なトークンを取得します。GmailのトークンではDriveを開くことはできません。共通しているのは、リポジトリ、インフラストラクチャライブラリ、認可フレームワーク、デプロイ手順のみです。

サービス

各サービスは、独立したプロセス、独立したMCPエンドポイント、独立したツールレジストリ、独立したGoogle権限セット、独立した認証情報ストレージを持ちます。

2層の認可

これらは独立しており、混在することはありません。

クライアント → サービス。 MCPクライアントは、PKCEと動的登録を備えたOAuth 2.1を通過します。発行されたトークンは単一のリソースにバインドされ、再利用検出付きのローテーション式リフレッシュトークンによって更新されます。

サービス → Google。 サービスは、所有者に代わって長期有効なリフレッシュトークンを使用してGoogleプロダクトAPIにアクセスし、アクセストークンを自ら更新します。Googleトークンは、いかなる場合もクライアントに返されません。

Googleの公式MCPエンドポイントはDeveloper Previewにあり、ここでは使用されません。呼び出しは安定版のプロダクトAPIに対して行われます。

要件

• Python 3.14。uvでインストールされます。システムインタープリタには影響しません。

• uv

• 5つのサービスのAPIとOAuthクライアントが有効なGoogle Cloudプロジェクト

インストール

uv sync --dev

チェック

uv run --no-sync pytest -q
uv run --no-sync ruff check .
uv run --no-sync ruff format --check .
uv run --no-sync mypy src

依存関係のバージョンをチェックする際は、--no-syncフラグが必須です。これがないと、uv runはロックファイルから環境を再同期し、実際のバージョンではなくピン留めされたバージョンを返すため、確実に壊れるパッケージバージョンでもチェックが成功してしまいます。

由来

このプロジェクトは、jimprosser/obsidian-web-mcpのOAuth 2.1コアをMITライセンスに基づいて適応させたものです。詳細はNOTICEに記載されています。

downstream OAuth 2.1の基盤は、リビジョン7e6a52d791a50e3bd533df1060217973ab5be1c8です。このリビジョン以降、コアには、クライアントとトークンのライフサイクル、リフレッシュトークンのローテーション、再利用検出、resourceの正規化に関する独自の修正が加えられています。

元のプロジェクトのドメイン部分（Obsidianストレージの操作とGitによる同期）は移植されていません。

ここではmcp>=2,<3が使用されています。MCP 2.0で削除されたmcp.server.fastmcpパッケージは不要であり、独自の構成はmcp.server.mcpserver上に構築されています。

ライセンス

MIT。LICENSEを参照してください。