gogcli-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 18+

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) | | 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