Surgical Google Docs editing for AI agents — search/replace, insert, comments, and more. MCP server.
概览
Surgical Google Docs editing for AI agents — preserves history, never touches character indices. An MCP server that makes Google Docs actually usable for LLMs. — no other tools required beyond a Google Cloud OAuth app. Compatibility note: the repo, package, CLI, env vars, and default token path now use google-docs-mcp. Backward-compatible google-drive-mcp command and env-var aliases are still accepted so existing setups do not break immediately. Indexing note: when the MCP reads document content before planning index-based edits, it requests suggestionsViewMode=SUGGESTIONS_INLINE. That keeps returned indices aligned for later documents.batchUpdate calls when the doc contains suggestions. Anchor text is matched against the document as it will read once pending suggestions are accepted (suggested deletions are ignored), so an edit can follow a suggestion made earlier. Tables note: text inside tables is read by docs_get and can be matched, edited and commented on like any other text.
README
以下为原文 README 节选，完整内容请查看原文。
google-docs-mcp
Surgical Google Docs editing for AI agents — preserves history, never touches character indices.
An MCP server that makes Google Docs actually usable for LLMs. Standalone — no other tools required beyond a Google Cloud OAuth app.
Compatibility note: the repo, package, CLI, env vars, and default token path now use google-docs-mcp. Backward-compatible google-drive-mcp command and env-var aliases are still accepted so existing setups do not break immediately.
Indexing note: when the MCP reads document content before planning index-based edits, it requests suggestionsViewMode=SUGGESTIONS_INLINE. That keeps returned indices aligned for later documents.batchUpdate calls when the doc contains suggestions. Anchor text is matched against the document as it will read once pending suggestions are accepted (suggested deletions are ignored), so an edit can follow a suggestion made earlier.
Tables note: text inside tables is read by docs_get and can be matched, edited and commented on like any other text.
Non-Docs note: the Docs API treats a Drive file that is not a Google Doc in two ways. A PDF is refused with a bare 400 Request contains an invalid argument, and docs_get then downloads it (up to 20 MB) and returns its extracted text with a read-only warning. A .docx is read without complaint (Docs converts it on the fly) but every write, edits and comments alike, is refused with The document must not be an Office file. Either way the MCP asks Drive what the file is: the edit tools fail with a message naming the file and its type, and the comment tools fall back to Drive comments on the file (see Comments).
Why
The Google Docs API uses character indices for every edit. LLMs are bad at counting characters. Everyone ends up deleting and rewriting entire documents, which destroys version history, comments, and collaborator attribution.
This server uses the same abstraction as code editors: search by text, not by position. You describe what to change; the server finds where it is and handles the index arithmetic.
Quick start
1. Run directly from GitHub
uvx --from git+https://github.com/dbuxton/google-docs-mcp google-docs-mcp --help
That command downloads the package, creates an isolated environment, installs dependencies, and runs the google-docs-mcp entry point.
No PyPI release is required. uvx can execute the tool straight from the GitHub repository.
To pin to a branch, tag, or commit, add a ref to the URL:
uvx --from git+https://github.com/dbuxton/google-docs-mcp@main google-docs-mcp --help
If you prefer a persistent local install instead of uvx, use:
uv tool install --from git+https://github.com/dbuxton/google-docs-mcp google-docs-mcp
uv tool install --from git+https://github.com/dbuxton/google-docs-mcp google-docs-mcp-auth
2. Create a Google Cloud OAuth app
安装
uvx --from git+https://github.com/dbuxton/google-docs-mcp google-docs-mcp配置
{
"mcpServers": {
"google-docs": {
"command": "uvx",
"args": ["--from", "git+https://github.com/dbuxton/google-docs-mcp", "google-docs-mcp"],
"env": {
"GOOGLE_DOCS_MCP_TOKEN": "/Users/you/.google-docs-mcp/token.json"
}
}
}
}