Gdocs MCP
Edit Google Docs by text snippet, review tracked changes and manage comments from an agent
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
- 3 days ago
About Gdocs MCP
Gdocs MCP is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Where many Google Docs connectors pull down a flat string and push a new one back, this server keeps tracked changes and comment threads intact. Edits are addressed by finding a unique snippet of text, the way a local file edit works, and integer indices are never exposed. An edit can also be submitted as a suggestion for a person to accept in Docs.
Pending suggestions are read back as the change inside its sentence, for example "Pay within [30→45] days", and each can be accepted or rejected on its own. Comment threads can be read with author, time and anchored text, replied to, resolved, or added on quoted text. A doc's tabs behave like sub-files, and several Google accounts can be authorised at once.
It is installed from npm and needs a Google Cloud OAuth client you create yourself. The project documents what Google's API cannot do, such as equations and page numbers, and the server refuses those instead of failing late. Nineteen tools in total, TypeScript, MIT licence.
Install
Run in a terminal
claude mcp add gdocs-mcp -- npx -y @dasasian/gdocs-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"gdocs-mcp": {
"command": "npx",
"args": [
"-y",
"@dasasian/gdocs-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gdocs-mcp": {
"command": "npx",
"args": [
"-y",
"@dasasian/gdocs-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gdocs-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dasasian/gdocs-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gdocs-mcp": {
"command": "npx",
"args": [
"-y",
"@dasasian/gdocs-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gdocs-mcp": {
"command": "npx",
"args": [
"-y",
"@dasasian/gdocs-mcp"
]
}
}
}What it does
- Snippet-based editing
- Match a unique piece of text and rewrite it, with no index handling.
- Suggestion review
- List pending tracked changes and accept or reject each one separately.
- Comment management
- Read threads, reply, resolve and comment on quoted text.
- Tabs as sub-files
- List, rename, reorder and nest a document's tabs like a folder.
- Multiple Google accounts
- Authorise several accounts and choose a default per project.
- Honest limits
- Refuses unsupported operations such as equations and page numbers and says what to write instead.
Good for
- Review a contract's tracked changes and accept the typo fixes
- Fill a proposal template while keeping its letterhead and styling
- Reply to and resolve open comment threads in a draft
- Publish a folder of markdown files as a Drive tree
- Audit many documents for style drift
Pricing
Open source
MIT licensed, free to use with your own Google Cloud OAuth client
Prices change. Check dasasian.com before you buy.
Gdocs MCP FAQ
How do I install it?
Run npm install -g @dasasian/gdocs-mcp, then add an account with gdocs-mcp add-account.
Do I need my own Google credentials?
Yes. You create a Desktop-app OAuth client in Google Cloud once, which keeps the credentials yours and avoids app verification.
Can the agent make suggestions instead of direct edits?
Yes. An edit can be submitted as a suggestion for a person to accept in Docs.
What licence is it under?
MIT.
Is Gdocs MCP free?
Yes. Gdocs MCP is open source, so you can use and self-host it for free.
How do I add Gdocs MCP to Claude Code?
Run this command in your terminal: claude mcp add gdocs-mcp -- npx -y @dasasian/gdocs-mcp
What are the best alternatives to Gdocs MCP?
The closest alternatives to Gdocs MCP are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.
Alternatives to Gdocs MCP

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents