Repository navigation
v1.0.0 — first stable release
Changelog
All notable changes to google-docs-mcp.
This project follows Semantic Versioning.
1.0.0 — 2026-05-18
First stable release.
Tool surface (18 tools, all gdocs_-prefixed):
- Create / convert / retrofit:
gdocs_make_tabbed_doc,gdocs_tab_existing_doc,gdocs_preview_tab_split - Edit tabs:
gdocs_add_tabs,gdocs_append_to_tab,gdocs_rename_tab,gdocs_delete_tab,gdocs_set_tab_icons,gdocs_replace_all_text - Read:
gdocs_get_doc_outline,gdocs_read_doc,gdocs_get_tab_url - Search / manage:
gdocs_find_doc_by_title,gdocs_trash_file,gdocs_untrash_file,gdocs_move_to_folder - Cloud-chat support:
gdocs_get_signed_upload_url - Server identity:
gdocs_server_info
Notable progression since pre-1.0 alpha:
- Native Google Docs Tabs (Oct 2024 sidebar feature) — every tool operates at the tab level, not just outline headings.
- Both stdio (Claude Desktop / Code) and remote HTTP (claude.ai via Fly.io) transports.
- Apps Script Web App setup automated via
setup-apps-script-autoCLI — collapses the 6-step UI dance into one OAuth consent. Opt-in--auth-mode=service-accountadds Domain-Wide Delegation for Workspace users wanting truly headless setup. - Signed-URL upload flow (
gdocs_get_signed_upload_url) for claude.ai's sandbox — bypasses the bytes-via-tool-args size limit AND the Drive-connector .docx corruption issue. - Soft-failure contracts on every mutate operation: 404 / 403 /
app_not_authorizedreturn as data, never raised. Batch operations skip-and-continue. - Retrofit injects synthetic Heading 1s into styled
.docxfiles with no headings (table-banner sections, etc.). Unicode-normalized + whitespace-collapsed + run-fragmentation-tolerant matching. - 76 tests (72 unit + 4 live integration). CI runs on every push/PR across Python 3.10–3.13.
- Deploy script (
deploy.sh) gates Fly.io deploys on local unit-test pass. gas_deploy/sub-package: clean boundary around Apps Script REST plumbing — extractable as a standalone package if a second consumer ever appears.
Known limitations (see README):
setActiveTab(persistent default-tab setting) not exposed. Usegdocs_get_tab_urlfor per-link deep linking instead — covers the common case.- Drive's converter 500s on
.docxfiles using<w:sym w:char="00A0"/>for NBSP. Our retrofit handles this construct correctly in-memory; the limitation is purely Drive's. Use the literal\xa0character inside<w:t>(the form Word actually produces) instead. - Per-tab headers/footers not supported. Tabs render as continuous scroll in the Docs UI; page headers only matter for paginated PDF export.