Google Docs

google-documents-mcp

Google Docs 用の MCP サーバーです。ドキュメントの読み取りと編集ができます。

ユースケース

ドキュメントに関する Q&A：「契約書には解除条項について何と書かれていますか？」→ ドキュメントを読み、該当するセクションを抜き出します。

会議からドキュメントを作成するワークフロー：通話後、Gemini の文字起こしとその後の Slack での議論を読み、決定事項をチーム憲章に反映します。

リリース告知：「GitHub の PR と #proj-awesome の Slack での議論をもとに、新機能についてのブログ記事を作成してください」→ 技術的な変更をユーザー向けのコンテンツにまとめます。

永続的なコンテキストを活用した日々の計画：AI アシスタントが毎日の開始時に「計画ログ」ドキュメントを読み、前日の進捗を尋ね、今日の優先事項の特定を支援し、計画をドキュメントに反映します。セッションをまたいでコンテキストが引き継がれるため、以前に行うと言ったことを記憶し、進捗を確認できます。

（これらはあくまで例です。ドキュメントの読み取りや編集が必要なワークフローであれば、どのようなものでも利用できます。ファイルの検索、削除、コメント、共有権限の管理には google-drive-mcp と組み合わせて使用してください。）

セットアップ

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

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成します（または既存のものを使用します）
3. Google Docs API を有効にします
4. APIs & Services → OAuth consent screen に移動し、同意画面を設定します
5. APIs & Services → Credentials → Create Credentials → OAuth client ID に移動します
6. Web application を選択します
7. Authorized redirect URIs に http://localhost:3000/callback を追加します
8. Client ID と Client Secret を控えておきます

2. サーバーを起動する

GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

サーバーはデフォルトで http://localhost:3000 で起動します。変更するには PORT=3001 を指定します。

3. MCP クライアントに追加する

サーバーを起動した状態で、install-mcp の手順に従ってください。MCP クライアント（Claude Code、Claude Desktop、Cursor、Cline、VS Code など）に適した設定が生成されます。

アーキテクチャ

このサーバーは Google への OAuth プロキシとして動作します。

graph LR
    A[MCP client] <--> B[google-documents-mcp] <--> C[Google OAuth/API]

1. サーバーは /.well-known/oauth-authorization-server を通じて、自身を OAuth 認可サーバーとして公開します
2. /register は Google OAuth クライアントの認証情報を返します
3. /authorize は、クライアントのコールバック URL を state にエンコードして Google にリダイレクトします
4. /callback は Google からコードを受け取り、クライアントのコールバックに転送します
5. /token はクライアントの認証情報を挿入し、トークンリクエストを Google に中継します
6. /mcp は MCP リクエストを処理し、ベアラートークンを使って Google Docs API を呼び出します

このサーバーはトークンや状態を保持せず、Google へのプロキシとしてのみ動作します。

ツール

ツール	説明
document_get_raw	すべてのタブ、書式、ヘッダー、フッター、スタイルを含む、ドキュメント全体の未加工 JSON 構造を取得します
document_get_text	すべてのタブのプレーンテキストを取得します
document_create	空の新規ドキュメントを作成します
document_batch_update	複数の編集を一括で適用します（挿入、削除、書式設定など）
document_append	ドキュメントの末尾にテキストを追加します
document_insert	指定したインデックスにテキストを挿入します
document_replace	テキストを検索して置換します

batch_update リクエストの種類

document_batch_update ツールでは、次の操作をサポートしています。

• insertText - 指定した位置にテキストを挿入します
• deleteContentRange - コンテンツの範囲を削除します
• replaceAllText - 一致するテキストをすべて検索して置換します
• insertInlineImage - 画像を挿入します
• insertTable - 表を作成します
• insertTableRow / insertTableColumn - 表に行または列を追加します
• deleteTableRow / deleteTableColumn - 表から行または列を削除します
• insertPageBreak - 改ページを追加します
• createNamedRange / deleteNamedRange - 名前付き範囲を管理します
• createParagraphBullets / deleteParagraphBullets - 箇条書きを管理します

Google Docs API のスコープ

• documents - ドキュメントの読み取りと編集へのフルアクセス

コントリビューション

GitHub でのプルリクエストを歓迎します！始めるには、次の手順に従ってください。

1. Git と Node.js をインストールします
2. リポジトリをクローンします
3. npm install で依存関係をインストールします
4. npm run test を実行してテストを実行します
5. npm run build でビルドします

リリース

バージョンはセマンティックバージョニング仕様に従います。

リリースするには、次の手順に従ってください。

1. npm version <major | minor | patch> を使用してバージョンを更新します
2. git push --follow-tags を実行してタグとともにプッシュします
3. GitHub Actions が NPM レジストリに公開するまで待ちます。