About gogcli-mcp-docs
gogcli-mcp-docs is an MCP server for operating Google Docs through gogcli, intended for Claude users automating document work. It adds tools for editing, formatting, exporting, and comments alongside authentication and core document operations.
Key features
- 01Read, create, and edit documents
- 02Insert, append, and delete content
- 03Apply character and paragraph formatting
- 04Export to multiple document formats
- 05List and manage comments
Use cases
- 01Make bulk changes to Google Docs
- 02Format documents and add comments
- 03Export documents as PDF or DOCX
MCP support
The MCP server exposes Google Docs tools to MCP clients, covering authentication, core document operations, editing, exporting, and comment management.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y gogcli-mcp-docsGOG_ACCOUNTEmail address of the Google account to use (matches gogcli auth)GOG_PATHOverride path to the gogcli binary (auto-discovered otherwise)DISPLAY_TZzone for *Display fields and for interpreting naive gog values; defaults to America/New_YorkGOG_READONLYblock all mutating gog API requests (injects gog's --readonly); set to 0/false/no/off (or unset) to allow writesGOG_TIMEZONEzone gog formats naive dates in; unset, runner.ts hands gog DISPLAY_TZ so the two cannot divergeLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
83Saved tool list · updated 2w ago
This tool takes no parameters.
Details
From the project READMEgogcli-mcp-docs
Warning
AI-developed project. This codebase was built and is actively maintained by Claude Code. Review all code and tool permissions before use.
Extended Google Docs MCP server via gogcli. Includes auth tools plus 18 additional dedicated Docs tools for editing, exporting, comments, and more.
Requirements
- gogcli installed and authenticated
- Node.js 22+
brew install gogcli
gog auth add [email protected] --services docs,drive
Installation
npm install -g gogcli-mcp-docs
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"gogcli-docs": {
"command": "gogcli-mcp-docs",
"env": {
"GOG_ACCOUNT": "[email protected]"
}
}
}
}
Claude Code
claude mcp add gogcli-docs -- gogcli-mcp-docs
Extra Docs Tools (18)
Plus 5 auth tools and 7 base Docs tools (info, cat, create, write, find-replace, structure, run).
| Tool | Description |
|---|---|
gog_docs_append | Append text or markdown to the end of a doc |
gog_docs_copy | Copy a document |
gog_docs_delete | Delete content by character index range |
gog_docs_edit | Find and replace with case-sensitivity control |
gog_docs_export | Export as PDF, TXT, HTML, DOCX, RTF, ODT, or EPUB |
gog_docs_format | Apply character / paragraph formatting (bold, color, alignment, …) |
gog_docs_insert | Insert text at a specific position |
gog_docs_list_tabs | List all document tabs |
gog_docs_read | Read doc as plain text or raw JSON |
gog_docs_sed | Stream-edit with sed-like regex expressions |
gog_docs_trash | Move a doc to Drive trash |
gog_docs_update | Update document content at a specific position |
gog_docs_comments_list | List comments (open or resolved), optionally with each comment's tab and index ranges |
gog_docs_comments_get | Get a comment with its replies |
gog_docs_comments_add | Add a comment with optional quoted text |
gog_docs_comments_reply | Reply to a comment |
gog_docs_comments_resolve | Resolve a comment |
gog_docs_comments_delete | Delete a comment |
Known limitations: gog_docs_append with markdown: true
These bugs live in gogcli's upstream markdown → Docs converter; the wrapper just passes --markdown through. Tracked upstream:
| Symptom | Workaround | Upstream |
|---|---|---|
| 3+ tables in one call reorders the trailing punctuation of the paragraph before the 3rd table | Split into multiple calls with ≤2 tables each | openclaw/gogcli#607 |
Inline **bold** / *italic* / `code` inside table cells renders as literal characters | Insert plain cell text, then apply formatting via gog_docs_format | openclaw/gogcli#608 |
| Tables with an empty header row leak the last data row as literal pipe text | Always supply a non-empty header row | openclaw/gogcli#609 |
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.