Skip to content

v1.0.0 — first stable release

Choose a tag to compare

@Sundeepg98 Sundeepg98 released this 18 May 05:21
· 272 commits to main since this 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-auto CLI — collapses the 6-step UI dance into one OAuth consent. Opt-in --auth-mode=service-account adds 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_authorized return as data, never raised. Batch operations skip-and-continue.
  • Retrofit injects synthetic Heading 1s into styled .docx files 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. Use gdocs_get_tab_url for per-link deep linking instead — covers the common case.
  • Drive's converter 500s on .docx files 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 \xa0 character 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.