Back to browse
GitHub Repository

Surgical Google Docs editing for AI agents — search/replace, insert, comments, and more. MCP server.

2 starsPython

Google Docs MCP that works

by dbuxton·Apr 22, 2026·2 points·0 comments

AI Analysis

●●SolidBig BrainNiche Gem

Search/replace editing beats character indices that break every other Google Docs MCP.

Strengths
  • Pattern-matching approach mirrors how code editors handle file edits, not fragile offsets.
  • Bookmark workaround for broken Comments API gets 80% of contract review workflows working.
  • Standalone setup needs only Google Cloud OAuth, no other tool dependencies.
Weaknesses
  • Google Docs Comments API has been broken for a decade, workaround remains hacky.
  • MCP server ecosystem is nascent; adoption depends on agent framework uptake.
Target Audience

Developers building AI agents that interact with Google Docs

Similar To

Cursor · Continue · Sourcegraph Cody

Post Description

Hi! Everyone I've shown this to has been confused that it didn't exist already, so thought I'd share with the wider community.

All the Google Docs MCPs out there seem to be broken in annoying ways so I thought I'd make one. For instance they do character-offset-based editing and LLMs are reliably terrible at counting characters.

This one just works. (It uses the similar pattern-matching search and replace that code editor harnesses use for file editing to minimize token usage and latency).

There are some showstoppers still. The most annoying is that Google Docs comments API is has been broken for over a decade (sic). I (well, Claude) build a workaround that involves inserting a bookmark with the Apps Script API and linking to that bookmark from the comment. It's hacky but for a lot of LLM-based workflows like contract review or similar it gets you 80% of where you want to be - you can say something like "add comments and [email protected] for anything that you want their opinion on".

I hope people find it useful. Install involves the usual dance with Google Cloud API console; apologies in advance for taking some happiness from your day.

Similar Projects

Developer Tools●●Solid

Treat Google Docs as Markdown

Token-efficient Google Docs editing for AI agents when gws and gogcli struggle with meaningful changes.

Big BrainNiche Gem
ksri
221mo ago