Google Drive MCP

Google Drive MCP Server

セルフホスト可能な1つのサーバーを通じて、MCP クライアントを Google Drive、Docs、Sheets、Slides、Calendar に接続できます。ファイルの検索や整理、Workspace コンテンツの作成や編集、共有の管理、複数ステップのワークフローの自動化を行いながら、すべての呼び出しで使用する Google の ID と認証情報を自分で管理できます。

このサーバーを選ぶ理由

• Drive を中心としたワークフロー： 130 個のツールで、ファイル管理、共有ドライブ、権限、リビジョン、Docs の高度な編集、Sheets の書式設定、Slides の作成、Calendar の予定を扱えます。
• ローカルまたはホスト型： 個人用のデスクトップクライアントには stdio、ホスト型の連携には Streamable HTTP、共有サービスには OAuth で保護されたチームモードを使用できます。
• ID の管理： ローカル OAuth では複数の Google アカウントとツールごとのアカウント選択に対応しており、サービスアカウントと外部で管理される OAuth トークンもサポートしています。
• エージェントに適したアクセス： ツールは対象を絞った操作を提供し、オプションの gdrive:/// リソースインターフェースでは直接の読み取りと検索に対応します。
• オープンでセルフホスト可能： 認証情報とトークンは、運用する環境内に保持されます。

このプロジェクトは、あらゆる Google Workspace API の公開を目指すのではなく、Drive とエディターの高度なワークフローに重点を置いています。

クライアントの互換性

互換性は、クライアントがサポートするトランスポートと認証フローによって決まります。

クライアントの種類	トランスポート	推奨モード
Claude Desktop	stdio	ローカル OAuth
Gemini CLI を含むその他のローカル MCP クライアント	stdio	ローカル OAuth
claude.ai のカスタムコネクター	Streamable HTTP	チームモード
その他のリモート MCP クライアント	Streamable HTTP	アクセス制御の背後にある単一 ID、または OAuth 2.1 を使用するチームモード

設定例とトランスポート要件については、クライアント設定を参照してください。

クイックスタート

1. Google OAuth 認証情報を作成する

Google Cloud プロジェクトで、次の操作を行います。

1. Drive、Docs、Sheets、Slides、Calendar API を有効にします。
2. OAuth 同意画面を設定し、アプリがテスト中の場合は Google アカウントをテストユーザーとして追加します。
3. アプリケーションの種類を デスクトップアプリ にして OAuth クライアントを作成します。
4. JSON ファイルをダウンロードし、次の名前で保存します。

~/.config/google-drive-mcp/gcp-oauth.keys.json

Google Cloud の設定手順と、認証情報の別の保存場所については、セットアップガイドを参照してください。

2. 認証する

npx -y @piotr-agier/google-drive-mcp auth

ブラウザーで Google の同意フローを完了します。デフォルトでは、トークンは ~/.config/google-drive-mcp/tokens.json に保存されます。

3. MCP クライアントにサーバーを追加する

共通の mcpServers 設定形式を使用するクライアントの場合：

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@piotr-agier/google-drive-mcp"]
    }
  }
}

設定を保存した後、クライアントを再起動します。Claude Desktop のパスと HTTP の例については、クライアント設定に記載されています。

4. 最初のツール呼び出しを行う

クライアントに次のように依頼します。

Run authGetStatus and tell me which Google account is active.

次に、読み取り専用の Drive リクエストを試します。

Search my Google Drive for files modified in the last seven days.

使用する ID が違っている場合や、検索でファイルが見つからない場合は、トラブルシューティングガイドを参照してください。

できること

Drive を整理する

Find PDF files in /Reports, create an Archive folder there, and move files older
than one year into it.

レポートを作成する

Create a Google Sheet for monthly results, summarize it in a Google Doc, and
create a short Google Slides presentation from the summary.

ドキュメントを編集する

Find the "Project Plan" document, replace the old launch date, format the new
date in bold, and add a comment describing the change.

会議の準備をする

Create a Calendar event with a Google Meet link and attach the project brief
from Drive.

ドキュメント

以前この README に記載されていた各セクションは、以下のガイドに移動しました。

ガイド	内容
セットアップ	要件、Google Cloud API、OAuth 認証情報、インストール
クライアント設定	対応するトランスポートとクライアント設定
認証	ローカル OAuth、複数アカウント、サービスアカウント、外部トークン、スコープ
設定	CLI フラグ、環境変数、デフォルト値、優先順位
デプロイ	Docker、Streamable HTTP、チームモード、リバースプロキシのセキュリティ
ツールリファレンス	Drive、Docs、Sheets、Slides、Calendar、アカウントのすべてのツール
トラブルシューティング	認証、API、ID、Docker、レート制限に関する問題
開発	リポジトリ構成、ビルドコマンド、テスト、コントリビューション

セキュリティ

• OAuth 認証情報、サービスアカウントキー、アクセストークン、リフレッシュトークン、tokens.json を絶対にコミットしないでください。
• 必要なツールを利用できる範囲で、最も制限の厳しい OAuth スコープを使用してください。
• サーバーが TLS とアクセス制御で保護されていない限り、HTTP のデフォルトのバインドアドレスは 127.0.0.1 のままにしてください。
• 共有デプロイでは、すべてのリクエストが呼び出し元として認証されるよう、チームモードを使用してください。
• team-store.json にはメンバーの Google リフレッシュトークンが含まれているため、秘密情報として扱ってください。

セキュリティと ID の仕組み全体については、認証とデプロイを参照してください。

開発とサポート

プロジェクトのビルドとテストについては、開発ガイドを参照してください。

• 不具合の報告や機能のリクエストは、GitHub Issuesで行ってください。
• リリースされた変更は、変更履歴で確認できます。
• プルリクエストによるコントリビューションを歓迎します。

ライセンス

MIT

謝辞

• Model Context Protocolを基盤としています。
• Google APIs Node.js Clientを使用しています。