Google Docs MCP

Google Docs MCP

英語 | ロシア語

A1 Google Docs MCP を使うと、AI アプリから自然言語で Google Docs を読み取り、編集できます。ドキュメントをテキストまたは Markdown として読み取り、指定した箇所を変更し、見出し、リスト、表のスタイルを設定したり、コメントスレッドを操作したり、結果を PDF や DOCX にエクスポートしたりできます。

Google アカウントを使って Google Docs API に接続します。推測ではなく、正確なインデックス範囲を指定して編集します。また、あらゆるドキュメント操作が可能であるかのように装うのではなく、Docs API の制限を明示します。

• 27 個のツール。 ドキュメントをテキスト、構造、Markdown として読み取り、正確な範囲を編集し、文字や段落のスタイルを設定し、リスト、表、区切り、画像、コメントスレッドを管理して、PDF、DOCX などにエクスポートします。
• 会話から接続できます。 「Google Docs に接続して」と伝えると、サーバーが OAuth クライアントの設定を案内し、PKCE を使って 127.0.0.1 で Google のリダイレクトを受け取り、トークンをサーバー内で管理します。設定ファイルも再起動も不要です。
• 編集はピンポイントです。 変更には正確なインデックス範囲を指定します。また、変更のたびに後続のインデックスがずれるため、編集の前に必ずドキュメントを再読み込みするようアシスタントに促します。
• Markdown のインポートとエクスポートに対応。 Markdown からドキュメントを作成したり、Markdown、PDF、DOCX などにエクスポートしたりできます。ドキュメント全体を Markdown で置き換える操作は、別途、破壊的な操作であることを明示して実行します。
• Drive の機能を隠して公開しません。 エクスポート、Markdown 変換、コメントでは内部的に Drive のエンドポイントを使用しますが、サーバーは汎用の Drive ツールを公開しません。

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

ローンチ計画のドキュメントを読み、未解決のコメントスレッドを要約してください。

サーバーに接続する · 利用例を見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： ローンチ計画のドキュメントのテキストとコメントを表示してください。

アシスタント： ドキュメントを簡潔なテキストブロックとして読み込み、コメントスレッドを一覧表示します。何も変更されません。

あなた： 「Timeline」の段落を、ベータ版の開始日が 3 月 3 日になるように書き換えてください。

アシスタント： 置き換える正確な範囲と変更後の文章を表示し、編集の前に確認を求めます。

あなた： 確認します。

アシスタント： その範囲だけを置き換えます。ドキュメントの残りの部分、書式、コメントはそのまま維持されます。

目次

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

クイックスタート

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

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

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

codex mcp list

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

claude mcp list

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

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

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

どのようなことを依頼できますか

ドキュメントを読み取ってエクスポートする

• このドキュメントを見出しや表も含めてテキストとして読み取り、要約してください。
• ハンドブックのドキュメントのタブツリーを表示してください。
• 仕様書を Markdown としてエクスポートし、契約書を PDF ファイルとして保存してください。

テキストを作成・編集する

• この Markdown から議事録ドキュメントを作成してください。
• 序文の後に要約の段落を挿入してください。
• ドキュメント内の「Q3」をすべて「Q4」に置き換えてください。
• 古くなった料金セクションを削除してください。

書式と構成

• これらの段落を番号付きリストに変換し、この行をレベル 2 の見出しにしてください。
• 重要な用語を太字にして、用語集へのリンクを設定してください。
• ロードマップ用の 3×4 の表を挿入し、ヘッダー行に内容を入力してください。
• 付録の前に改ページを挿入し、公開 URL の画像を追加してください。

コメントを扱う

• 未解決のコメントスレッドを一覧表示して要約してください。
• 期限に関するコメントに返信し、解決済みにしてください。
• 法務確認が必要な文を引用したコメントを追加してください。

ドキュメントの変更の仕組み

1. create_document はドキュメントを作成します。空の状態で作成することも、1 回の呼び出しで Markdown から変換して作成することもできます。
2. コンテンツはインデックスで指定します。これはタブ本文内の UTF-16 位置を表し、挿入や削除のたびに、それより後ろのすべてのインデックスがずれます。サーバーは、各編集の前に read_document_text から最新のインデックスを取得し、ドキュメントの末尾から逆順に編集するようアシスタントを誘導します。
3. import_markdown は本文全体を置き換えます。コメントのアンカー、配置済みオブジェクト、ヘッダー／フッター、追加のタブは変換後に保持されません。
4. タブは読み取りや対象の指定ができますが、API では作成、名前の変更、削除、並べ替えはできません。
5. コメントは Drive に保存され、スレッドとして管理されます。テキスト範囲に新しいコメントを固定することはできません。アンカー形式が公開されていないためです。そのため、コメントはドキュメント単位で追加され、必要に応じて対象のテキストを引用できます。

エクスポートの上限は 10 MB で、コメントや提案は含まれません。インライン画像は Google が公開 URL から取得します（PNG／JPEG／GIF、最大 50 MB、2,500 万ピクセル）。画像ファイルをアップロードする手段はありません。

変更できる内容

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

アクセスの取得

Google Docs の利用には OAuth 2.0 が必要です。API キーだけでは不十分です。アクセス方法は 2 つあり、1 つ目は設定ファイルが不要です。

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

「connect Google Docs」と伝えると、アシスタントが手順を案内します。

1. setup_instructions がチェックリストを表示します。Google Cloud プロジェクトの作成または選択、Google Docs 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-docs/credentials.json（モード 0600）に保存します。

トークンは呼び出しのたびに再読み込みされるため、AI アプリを再起動せずにすぐ接続できます。auth_status で接続状況を確認でき、logout で接続を取り消して認証情報を削除できます。

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

1. Google Cloud プロジェクトを作成または選択し、Google Docs API と Google Drive API の両方を有効にします（エクスポート、Markdown 変換、コメントには Drive エンドポイントを使用します）。

2. OAuth 同意画面を設定し、Desktop app OAuth クライアントを作成します。

3. ドキュメントの所有者、または編集権限を持つ Google アカウントを認証します。OAuth 2.0 Playground では、Use your own OAuth credentials を有効にすると、リフレッシュトークンを取得できます。

4. 次の両方のスコープをリクエストします。

   https://www.googleapis.com/auth/documents
   https://www.googleapis.com/auth/drive
   

   より限定的な設定では、エクスポート、Markdown、コメントの対象がこの OAuth クライアントを通じて作成されたドキュメントのみの場合、drive.file で十分です。また、読み取り専用ツールには、読み取り専用の組み合わせである documents.readonly + drive.readonly で十分です。

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

設定

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

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

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

• リクエストは Google に送信されます。 ローカルサーバーは Google OAuth トークンを更新して Docs API を呼び出します。エクスポート、Markdown 変換、コメントでは、内部的に Drive API エンドポイントを使用します。匿名テレメトリーに含まれるのは、インストール ID、パッケージのバージョン、AI クライアントとプラットフォームのバージョン、ツール名のみです。OAuth トークン、ドキュメントの内容、ツールの引数、プロンプトは含まれません。オプトアウトするには ASKADS_TELEMETRY=0 を設定してください。
• Google には 1 分あたりのクォータがあります。 429 が返された場合、サーバーは待機時間を延ばしながら再試行します。また、読み取りではネットワークエラーと 5xx エラーの後にも再試行しますが、書き込みでは不確実な失敗の後に再実行されることはありません。書き込みを再実行すると、編集が重複する可能性があるためです。
• バックグラウンドでのポーリングはありません。 サーバーは呼び出されたときのみ動作します。AI アプリがスケジュールタスクに対応している場合は、ドキュメントやコメントを定期的に確認できます。

技術ドキュメント

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

サポート

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

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