google-drive-comments-mcp

google-drive-comments-mcp

Google Drive ファイル（Docs、Sheets、Slides）のコメントを読み取ることに特化したModel Context Protocolサーバー（およびスタンドアロン CLI）です。ツールは2つで、OAuth スコープは読み取り専用、余計な機能はありません。

ホスト型の Google Drive コネクターではファイルのコンテンツや検索は利用できますが、コメントスレッド（レビューでの議論、引用箇所、解決／再開の履歴）は取得できないため、これを開発しました。このサーバーは、あらゆる MCP クライアント（Claude Code、Claude Desktop、Cursor、Cline など）でその不足を補い、通常の CLI としても使用できます。

特長

• MCP ツールは2つ — drive_search_files、drive_get_comments。API はこれだけです。
• コメントスレッド全体を読み取ります — 作成者、内容、引用箇所のテキスト、解決済み／未解決の状態、すべての返信（解決／再開の操作を含む）。
• Docs、Sheets、Slides で動作します — Drive のコメント API は、ファイルの種類を問わず共通です。
• URL または ID を受け付けます — docs.google.com/document/d/… のリンクまたはファイル ID を貼り付けてください。
• 読み取り専用の OAuth スコープ（drive.readonly）。
• 環境変数で設定 — DRIVE_MCP_CREDENTIALS、DRIVE_MCP_TOKEN、DRIVE_MCP_SCOPES。

インストール

pip install google-drive-comments-mcp
# or, with uv:
uv tool install google-drive-comments-mcp

初回セットアップ（約10分）

Google Cloud の OAuth クライアントが必要です。サーバーはすべてお使いのマシン上で実行され、データが外部に送信されることはありません。

1. Google Drive のコメントを読み取りたいアカウントでGoogle Cloud Consoleにサインインします。
2. プロジェクトを作成するか、既存のプロジェクトを選択します。
3. Drive API を有効にします：console.cloud.google.com/apis/library/drive.googleapis.com。
4. APIs & Services → OAuth consent screen で OAuth 同意画面を設定します：
   • Google Workspace ユーザー：ユーザータイプを Internal にします。drive.readonly は制限付きスコープですが、アプリの検証は不要です。
   • 個人の Gmail ユーザー：ユーザータイプを External にし、「Test users」に自分のアドレスを追加します。
5. APIs & Services → Credentials → + Create credentials → OAuth client ID
   • アプリケーションの種類：Desktop app
   • JSON をダウンロードします。
6. セットアップを実行します：

google-drive-comments-mcp setup --import-credentials ~/Downloads/client_secret_*.json

OAuth の同意を求めるブラウザーウィンドウが開きます。リフレッシュトークンは ~/.config/google-drive-comments-mcp/token.json にキャッシュされます。

確認：

google-drive-comments-mcp status
google-drive-comments-mcp comments "https://docs.google.com/document/d/YOUR_DOC_ID/edit"

Claude Code から使用する

claude mcp add --scope user google-drive-comments google-drive-comments-mcp -- serve

続けて、次のように指示します：

このドキュメントの未解決コメントを読み、レビュアーが求めていることを要約してください：https://docs.google.com/document/d/…

Claude Desktop から使用する

~/Library/Application Support/Claude/claude_desktop_config.json（Mac）：

{
  "mcpServers": {
    "google-drive-comments": {
      "command": "google-drive-comments-mcp",
      "args": ["serve"]
    }
  }
}

（Claude Desktop の $PATH に含まれていない場合は、which google-drive-comments-mcp で確認した絶対パスを使用してください。）

シェルから使用する

# Find a doc
google-drive-comments-mcp search "Q3 strategy"

# Read all comments (open + resolved) on a doc by URL or ID
google-drive-comments-mcp comments "https://docs.google.com/document/d/abc123/edit"

# Only unresolved comments
google-drive-comments-mcp comments abc123 --open-only

MCP ツール2つ

drive_search_files(query, max_results=10)

Drive を検索します。通常の文字列はファイル名の検索として自動的に処理されます。Drive のクエリー構文はそのまま使用できます。

[
  {
    "id": "1AbC…",
    "name": "Q3 Strategy",
    "mime_type": "application/vnd.google-apps.document",
    "modified": "2026-04-20T09:00:00.000Z",
    "owners": ["Jane Doe"],
    "web_view_link": "https://docs.google.com/document/d/1AbC…/edit"
  }
]

drive_get_comments(file, include_resolved=True)

ファイルのすべてのコメントを読み取ります。file には Docs／Sheets／Slides／Drive の URL またはファイル ID を指定できます。

{
  "file": { "id": "1AbC…", "name": "Q3 Strategy", "mime_type": "…document", "web_view_link": "…", "owners": ["Jane Doe"] },
  "open_count": 2,
  "resolved_count": 1,
  "comments": [
    {
      "id": "AAAA…",
      "author": "Jane Doe",
      "content": "Can we add the unit-economics table here?",
      "quoted_text": "Our margins improved in Q3.",
      "resolved": false,
      "created": "2026-04-21T10:00:00Z",
      "modified": "2026-04-21T10:00:00Z",
      "replies": [
        { "author": "John Smith", "content": "Added.", "action": "", "created": "2026-04-21T11:00:00Z" }
      ]
    }
  ]
}

quoted_text は、コメントが紐付けられているドキュメント内のテキストです。各コメントが何を指しているかを理解するのに役立ちます。

設定

変数	デフォルト	説明
DRIVE_MCP_CREDENTIALS	~/.config/google-drive-comments-mcp/credentials.json	OAuth クライアントシークレットの JSON
DRIVE_MCP_TOKEN	~/.config/google-drive-comments-mcp/token.json	キャッシュされたリフレッシュトークン
DRIVE_MCP_SCOPES	https://www.googleapis.com/auth/drive.readonly	OAuth スコープ（カンマ区切り）
XDG_CONFIG_HOME	~/.config	標準の XDG 上書き設定

Google MCP ツール間で1つのログインを共有する

兄弟ツール（例：gmail-attachments-mcp）も実行していて、両方で1回の OAuth 同意を使いたい場合は、両方のツールが同じ認証情報ファイルとトークンファイルを参照するように設定し（上記の環境変数またはシンボリックリンクを使用）、両方を合わせたスコープで一度だけ認証してください：

DRIVE_MCP_SCOPES="https://www.googleapis.com/auth/gmail.readonly,https://www.googleapis.com/auth/drive.readonly" \
  google-drive-comments-mcp setup --reauth

要求されるスコープをすべて含むトークンであれば、各ツールが要求するより狭いスコープも満たします。

セキュリティ

• 読み取り専用：デフォルトのスコープは drive.readonly です。編集、コメント、削除はできず、ファイルのメタデータ、内容、コメントを読み取ることのみ可能です。
• スコープの範囲：drive.readonly は、クエリ対象のファイルだけでなく、Google Drive 内のすべてのファイルへの読み取りアクセスを許可します。コメントも参照できるファイル単位の読み取りスコープはありません。キャッシュされたトークンはパスワードと同様に扱ってください（0600 で書き込まれます）。
• テレメトリーなし：OAuth クライアントはご自身の Google Cloud プロジェクトにあります。データがご使用のマシンから外部に送信されることはありません。

トラブルシューティング

Claude Desktop / cron で HttpError 403: Google Drive API has not been used in project … before or it is disabled が表示される OAuth クライアントを所有するプロジェクトで Drive API を有効にしてから、再試行してください。

Claude Desktop / cron で No valid Google token が表示される ブラウザーを開けるターミナルで google-drive-comments-mcp setup を一度実行してください。以降の実行では、キャッシュされたトークンが再利用されます。

コメントがあると分かっているファイルで、コメントが空で返される 実際にそのファイルを閲覧できるアカウントを認証したこと、また、そのファイルに本当にコメントがあること（提案はコメントではありません）を確認してください。--open-only / include_resolved=false を指定しない限り、解決済みのコメントも含まれます。

認証 — Google OAuth クライアントを自分で用意する

API キーや同梱されたシークレットはありません。サーバーは、ご自身で作成した OAuth クライアントを使ってご自身の Google アカウントに認証し、更新トークンをローカルにキャッシュします。作者がデータにアクセスすることは一切ありません。

• なぜ自分のクライアントが必要なのですか？ Google の制限付きスコープ（ここでは drive.readonly）は共有アプリで再配布できず、未検証の共有アプリはユーザー数が100人までに制限されています。「OAuth クライアントを自分で用意する」方式は、個人データを扱う MCP サーバーで一般的なパターンです。
• 必要なもの： 無料の Google Cloud プロジェクト、Drive API の有効化、OAuth 同意画面、デスクトップ OAuth クライアント。詳しい手順 → docs/setup-google-oauth.md。
• トークンの保存場所： ~/.config/google-drive-comments-mcp/token.json（モード 0600）。ローカルで無効にするには削除してください。完全に取り消すには myaccount.google.com/permissions をご利用ください。
• ホステッド／SaaS の選択肢はありません — すべてローカルで実行され、Drive のデータがサードパーティのサーバーに渡ることはありません。

その他のガイド

• docs/setup-google-oauth.md — OAuth の詳しい手順とよくあるエラー
• docs/claude-code.md · docs/claude-desktop.md · docs/other-clients.md — クライアントごとの設定（Cursor、Cline、Continue、…）
• examples/ — 実行可能なサンプル

関連ツール

ホステッドコネクターでは公開されていない Google Workspace データを扱う、特化型のローカル MCP サーバー群の一部です：

• gmail-attachments-mcp — Gmail の添付ファイルのバイトデータをディスクにダウンロード
• google-drive-comments-mcp — Docs／Sheets／Slides のコメントスレッドを読み取り（このリポジトリ）
• google-drive-files-mcp — Drive ファイルを移動／整理

OAuth ログインを1つ共有することも、分けておくこともできます。設定については各リポジトリをご覧ください。

ライセンス

MIT。LICENSE をご覧ください。