Google Docs MCP server
io.github.gigabrain-observer/google-docs-mcp-server·v0.1.1·4 starsGoogle Docs MCP server with full tab support, markdown extraction, and batch updates.
4 stars21 downloads/wk
Reviews
Write oneNobody has reviewed Google Docs yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Google Docs tools (9, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
append_textAppend text to the end of a Google Doc tab.
batch_updatewrite actionExecute a batch update on a Google Doc using the full batchUpdate endpoint. This provides access to all batchUpdate operations including formatting, styling, and structural changes.
create_documentwrite actionCreate a new Google Doc.
get_document_infoGet metadata about a Google Doc (title, ID, link, tabs). Lightweight.
insert_textwrite actionInsert text at a specific character index in a Google Doc tab.
list_documentsSearch for Google Docs in Drive by name.
list_tabsList all tabs in a Google Doc.
read_documentRead a Google Doc tab and return its content as markdown-formatted text. If no tab is specified, reads all tabs with headers.
replace_textFind and replace all occurrences of text in a Google Doc. Can target a specific tab.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 210 days ago4/15
- Maintainer identitynamespace and repository owner differ4/10
How Google Docs compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 69/100
- higher than 28% of 1,299 Productivity servers
- Tools
- 9
- the typical Productivity server has 7
- Tools that change things
- 33%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 4
- more than 68% of 854 Productivity servers
- Downloads a week
- 21
- more than 6% of 427 Productivity servers with a package
What its tools let an agent do: 5 read · 2 create · 2 change
Install Google Docs in Claude Code, Cursor or VS Code
claude mcp add google-docs-mcp-server -- uvx google-docs-mcp-server
What the publisher says
From the Google Docs repository's README, as published. We do not edit it. Read it on GitHub
Google Docs MCP Server
A Model Context Protocol server for Google Docs with full tab support — something most existing servers get wrong or skip entirely.
Uses Google service accounts with domain-wide delegation, so it works in Workspace orgs without OAuth consent screens.
<!-- mcp-name: io.github.gigabrain-observer/google-docs-mcp-server -->
What it does
All tab-targeting tools accept tabid or tabtitle (case-insensitive). The batch_update tool auto-injects tabId into requests so you don't have to.
Why this exists
Google Docs has supported tabs since late 2024, but most MCP servers either:
- Ignore tabs entirely (only read the first tab)
- Don't use includeTabsContent=True, so tab content is invisible
- Don't handle nested tabs
This server handles all of that correctly and converts content to markdown with proper heading structure.
Install
pip install google-docs-mcp-serverOr run directly with uv:
uvx google-docs-mcp-serverPrerequisites
- Python 3.11+
- A Google Cloud service account with domain-wide delegation
Setup
1. Create a GCP service account
- Go to Google Cloud Console and create (or select) a project
- Enable the Google Docs API and Google Drive API
- Create a service account under IAM & Admin > Service Accounts
- Create a JSON key and download it
2. Enable domain-wide delegation
- In GCP, on the service account details page, enable Domain-wide Delegation and note the Client ID
- In Google Workspace Admin > Security > API Controls > Domain-wide Delegation
- Add the Client ID with these scopes:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive.readonly3. Configure your MCP client
Add to your MCP config (e.g. ~/.claude/mcp.json or .mcp.json):
{
"mcpServers": {
"google-docs": {
"command": "uvx",
"args": ["google-docs-mcp-server"],
"env": {
"SERVICE_ACCOUNT_PATH": "/path/to/your-service-account-key.json",
"SUBJECT_EMAIL": "you@yourdomain.com"
}
}
}
}SUBJECT_EMAIL is the Workspace user the service account impersonates.
Environment variables
License
MIT
Nothing above is checked by us. What we check is on the safety report.
Google Docs: common questions
- Is Google Docs MCP server safe?
- With care: it is graded C, so read the findings first (69/100). Read the Google Docs safety report
- How do I install Google Docs?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Google Docs need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is Google Docs maintained?
- The last commit was 247 days ago (2026-03-02). The latest release is v0.1.1.
- What can I use instead of Google Docs?
- Servers from other publishers that do the same job: Gsheets MCP server, OrchestKit Docs MCP server and Wet MCP server.
- How does Google Docs compare with other Productivity MCP servers?
- safety score 69/100 (higher than 28% of 1,299 Productivity servers); tools 9 (the typical Productivity server has 7); tools that change things 33% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Google Docs
Same job from other publishers: the closest match first, then the best rated.
- GsheetsMCP server for Google Sheets API — read, write, format, batch operations.not reviewedEstablishedB
- OrchestKit Docs MCPRead-only MCP server for the OrchestKit docs: full-text search + Markdown fetch. No auth.not reviewedEstablishedA
- WetOpen-source MCP server for AI agents: web search, content extraction, and library docs.not reviewedGrowingB
- Google Drive MCPSecure access to Google Drive, Docs, Sheets, Slides, and Calendar through MCP.not reviewedGrowingB
Context7Up-to-date docs for AI agentsnot reviewedWidely usedA