google-docs-mcp-server は何をしますか？
🔗 LLMをGoogle Docsに接続する非公式MCPサーバー。スマートなワークフローと強化された文書管理を実現します。
概要
このMCPサーバーは、LLM（大規模言語モデル）とGoogle Docsの間のブリッジとして機能します。標準化されたMCPプロトコルを使用することで、AIエージェントはGoogle Docsの文書に対して読み取り、書き込み、更新、検索などの操作を直接実行できます。
主な機能
- 文書の読み取り: Google Docsの文書内容を構造化された形式で取得
- 文書の作成: 新しい文書をテンプレートまたはプレーンな内容から生成
- 文書の編集: 既存の文書への追記、修正、フォーマット変更
- 全文検索: 文書内のテキストを検索して一致箇所を特定
- メタデータ取得: 文書のタイトル、作成者、更新日時などの情報を取得
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他MCP対応のAIエージェント
セットアップ
前提条件
- Node.js 18以上
- Google Cloudプロジェクト（Google Docs APIが有効化されていること）
- OAuth 2.0クライアント認証情報
インストール
npm install -g @mattaspira/google-docs-mcp-server
設定
- Google Cloud ConsoleでOAuth 2.0クライアントIDを作成
- 以下の環境変数を設定:
export GOOGLE_CLIENT_ID="your-client-id"
export GOOGLE_CLIENT_SECRET="your-client-secret"
export GOOGLE_REFRESH_TOKEN="your-refresh-token"
export MCP_PORT=3000
起動
google-docs-mcp-server start
使用方法
MCPツールとして利用
AIエージェント（例：Claude Code）から以下のツールとして利用できます：
read_document(docId)- 指定された文書IDの内容を読み取るcreate_document(title, content)- 新しい文書を作成edit_document(docId, edits)- 既存の文書を編集search_document(docId, query)- 文書内を検索
例
{
"tool": "create_document",
"args": {
"title": "プロジェクト計画書",
"content": "# プロジェクト計画\n\n## 目標\n..."
}
}
認証
OAuth 2.0を使用した安全な認証を実装しています。初回認証後はリフレッシュトークンで自動更新されます。
制限事項
- 非公式のMCPサーバーであるため、Googleの公式サポート対象外
- 大量の文書操作にはレート制限が適用される場合があります
- 一部の高度なGoogle Docs機能（スクリプト、アドオン等）には対応していません
ライセンス
MIT