Google Drive MCP

Google Drive MCP

日本語 | Русский

A1 Google Drive MCP を使うと、AI アプリから Google Drive を自然言語で操作できます。ファイルを探したり、フォルダーを整理したり、コンテンツをアップロード・ダウンロードしたり、Google ドキュメントを Markdown にエクスポートしたり、適切な相手と共有したりできます。また、ゴミ箱を経由することで、完全な削除を防げます。

Google アカウントで Google Drive API を使用します。マイドライブと共有ドライブの両方を対象とし、「削除」は取り消し可能なゴミ箱への移動として扱います。また、すべてのファイル操作が可能であるかのように装うのではなく、Drive API の制限を明示します。

• 21 個のツール。 検索とメタデータ、フォルダーと移動、アップロードとダウンロード、Google ドキュメント／スプレッドシート／スライドのエクスポート、ゴミ箱、共有とコメントに対応します。
• 会話から接続。 「Google Drive に接続」と伝えると、サーバーが OAuth クライアントの設定を案内し、PKCE を使って 127.0.0.1 への Google のリダイレクトを受け取り、トークンをサーバー内に保持します。設定ファイルも再起動も必要ありません。
• まずはゴミ箱へ。 「削除」は取り消し可能なゴミ箱への移動を意味します。完全な削除には、誤って選択できないよう意図的に別のツールを用意しています。
• ドキュメントの内容はそのまま。 Google ドキュメント、スプレッドシート、スライドは、ファイル全体として移動、コピー、エクスポート、変換されます。サーバーが内部のテキストを編集することはありません。
• スコープは自分で選択。 drive.readonly はすべての読み取り操作に対応し、drive.file はアプリが作成したファイルにアクセスを制限します。すべてのツールを利用するには drive が必要です。

まずは読み取り専用の質問から始めましょう。

マイドライブからプロジェクトのロードマップのドキュメントを探し、Markdown にエクスポートして要約してください。

サーバーに接続 · ユースケースを見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： 「Contracts 2025」フォルダーの中身を、新しい順に表示してください。

アシスタント： ファイルの種類、オーナー、更新日とともに一覧を表示します。変更はありません。

あなた： 「Archive」サブフォルダーを作成し、1 年以上前のファイルをすべてそこに移動する準備をしてください。

アシスタント： 作成するフォルダーと移動するファイルを表示し、確認を求めます。

あなた： 確認します。

アシスタント： フォルダーを作成し、ファイルを移動します。別途依頼しない限り、共有、ゴミ箱への移動、削除は行いません。

目次

• クイックスタート
• 依頼できること
• Drive の変更内容
• 変更できる内容
• アクセス権の取得
• 設定
• データ、制限、バックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20+ と Google アカウントが必要です。インストール時に認証情報は不要です。サーバーは会話中に接続します。

1. AI アプリにサーバーを追加します。
2. 「Google Drive に接続して」と伝えると、アシスタントが設定ファイルを編集することなく、OAuth クライアントの作成とアクセスの承認を案内します。
3. 上記の読み取り専用の質問をします。

codex mcp add google-drive \
  -- npx -y @a1-x-tech/mcp-google-drive@latest

codex mcp list

claude mcp add \
  --transport stdio --scope user google-drive \
  -- npx -y @a1-x-tech/mcp-google-drive@latest

claude mcp list

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

{
  "servers": {
    "google-drive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

できること

ファイルを検索して読む

• 前四半期の予算スプレッドシートを見つけて、保存場所と所有者を教えてください。
• プロジェクト概要を Markdown にエクスポートして、未解決の質問を要約してください。
• 署名済み契約書の PDF をレポートフォルダーにダウンロードしてください。

コンテンツを整理して移動する

• 「2026 Reports」フォルダーを作成し、月次レポートをそこに移動してください。
• この会議メモをアップロードして、Google ドキュメントに変換してください。
• 提案書のテンプレートをコピーして、新しいクライアント向けの名前に変更してください。

共有して話し合う

• フォルダーをチームメイトと共有し、コメント権限を付与して、招待にメモを追加してください。
• デザインドキュメントの未解決コメントを一覧表示し、対応済みのものを解決してください。
• 外部委託業者のアーカイブへのアクセス権を取り消してください。

必要に応じて整理する

• 古い下書きをゴミ箱に移動し、誤って削除したものは復元してください。
• 確認後、テストアップロード用フォルダーを完全に削除してください。
• ゴミ箱を空にする前に、中身を表示してください。

Drive の変更内容

1. フォルダーや共有ドライブのアイテムも含め、Drive 内のすべてのものは ID を持つファイルです。名前は一意ではないため、ツールは ID を使って操作します。また、名前の重複は許可されているため、作成前に検索することをおすすめします。
2. 「削除」とは、ゴミ箱への移動を意味します。元に戻すことができ、約 30 日後に Google によって自動的に完全削除されます。完全削除はゴミ箱を経由せず、フォルダー内のすべてのアイテムも削除します。この操作には、意図的に別のツールが用意されています。
3. Google Docs、Sheets、Slides は、ファイル全体を単位として移動、コピー、共有、エクスポート、変換されます。サーバーには、Doc 内のテキストや Sheet 内のセルを編集するツールはありません。
4. 不確実な障害の後に書き込みが再実行されることはありません。ネットワークエラーや 5xx エラーの後の再試行は読み取りのみに適用されるため、コピー、アップロード、新しいフォルダーが知らないうちに重複することはありません。

組み込みのアップロードは 5 MB に制限されています（それより大きなファイルは raw_request を使った再開可能なセッションでアップロードします）。エクスポートは Drive API の仕様により、1 件あたり 10 MB までです。API 経由で作成したコメントは、Doc 内の特定の箇所に紐づけることができません。

変更できる内容

確認プロンプトは AI クライアントが制御します。サーバーは読み取り、書き込み、破壊的なツールを識別できるように分類するため、クライアントは状態の確認と実際の変更を区別できます。

アクセスの取得

Google Drive では OAuth 2.0 が必要です。API キーだけでは利用できません。アクセス方法は 2 つあり、1 つ目は設定ファイルが不要です。

チャットから接続する（推奨）

「Google Drive に接続して」と伝えると、アシスタントが一緒に手順を進めます。

1. setup_instructions でチェックリストが表示されます。Google Cloud プロジェクトを作成または選択し、Google Drive API を有効にして、同意画面を設定し、Desktop app の OAuth クライアントを作成します。
2. そのクライアントの JSON（「Download JSON」）をダウンロードし、アシスタントにそのパスを渡します。set_client が所有者のみ読み取り可能な状態で保存します。シークレットが会話を通じて送信されることはありません。
3. start_login から Google の同意リンクが返されます。このマシンでリンクを開いて承認すると、コードはチャットを経由せず、127.0.0.1 上の一度限りのリスナー（PKCE）に返されます。
4. finish_login がコードを交換し、トークンを ~/.config/mcp-google-drive/credentials.json（モード 0600）に保存した後、実際の Google Drive API 呼び出しで検証します。そのため、API がまだ無効になっている場合は、その場で検出されます。

呼び出しごとにトークンが再読み込みされるため、AI アプリを再起動しなくても接続がすぐに有効になります。auth_status で接続状態を確認でき、logout で接続を取り消して認証情報を削除できます。

環境変数（CI、無人インストール）

1. Google Cloud プロジェクトを作成または選択し、Google Drive API を有効にします。

2. OAuth 同意画面を設定し、デスクトップアプリの OAuth クライアントを作成します。

3. サーバーで操作するファイルを所有する Google アカウントを認証します。OAuth 2.0 Playground では、Use your own OAuth credentials を有効にするとリフレッシュトークンを取得できます。

4. 用途を満たす最小限のスコープをリクエストします。

   スコープ	有効になる機能
   https://www.googleapis.com/auth/drive.readonly	読み取り専用ツール：検索、メタデータ取得、ダウンロード、エクスポート、共有ドライブの一覧表示。
   https://www.googleapis.com/auth/drive.file	このアプリで作成または開いたファイルのみ — アプリ所有ファイルのアップロードと整理のワークフローには十分です。
   https://www.googleapis.com/auth/drive	ツールの全機能：任意のファイルの共有、ゴミ箱への移動、削除、コメント。

サーバーはリフレッシュトークンの発行時に指定されたスコープを使用します。その範囲外の呼び出しは、insufficientPermissions エラーで失敗します。

テストモードの OAuth リフレッシュトークンは、7 日後に期限切れになる場合があります。長期間アクセスする必要がある場合は、OAuth アプリを公開するか、Workspace ドメイン内の内部アプリを使用してください。クライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。

設定

すべての変数は任意です。何も設定しない場合、サーバーはチャットから接続します。

* OAuth の 3 つの値、またはアクセストークンのいずれかを指定してください。

認証情報がなくてもサーバーは起動して MCP ハンドシェイクを完了します。最初のツール呼び出しでは、サーバーが応答しなくなるのではなく、設定すべき変数がそのまま返されます。

データ、制限、バックグラウンド処理

• リクエストは Google Drive に送信されます。 ローカルサーバーは Google OAuth トークンを更新し、Drive API を呼び出します。匿名のテレメトリに含まれるのは、インストール ID、パッケージバージョン、AI クライアントとプラットフォームのバージョン、ツール名のみです。OAuth トークン、ファイルの内容、ツールの引数、プロンプトは含まれません。オプトアウトするには ASKADS_TELEMETRY=0 を設定してください。
• Google によってクォータとサイズ上限が適用されます。 組み込みツールでのアップロードは 5 MB、エクスポートは 10 MB に制限されています。429 が発生するとサーバーはバックオフを使用します。読み取りではネットワークエラーと 5xx エラーの後にも再試行しますが、書き込みは失敗したかどうか不明な場合に再実行されません。
• ローカルファイルは慎重に扱われます。 ダウンロードは絶対パスにのみ保存され、明示的に要求されない限り既存のファイルを上書きしません。インラインで返されるテキストコンテンツの上限は 100 KB です。
• バックグラウンドでのポーリングは行いません。 サーバーは呼び出されたときのみ実行され、リクエストの間に Drive を監視することはありません。AI アプリがスケジュールタスクに対応している場合は、定期的に変更を確認できます。

技術ドキュメント

• MCP 機能カタログ — すべてのツールについて、タスク別にまとめたページ。
• すべてのツールと入力
• 開発ドキュメント
• 公開ドキュメント
• Google Drive API リファレンス

サポート

バグを見つけた場合や、必要なシナリオがある場合は、issue を作成するか、Telegramに書き込んでください。

最後までご覧いただき、ありがとうございます！