Read a Google Doc and return its structure as JSON.

Returns title, list of paragraphs (with text, style, start/end indices), and the full plain text. Use this before editing to understand the document.

Find text in a Google Doc and replace a specific occurrence.

Preserves document history — uses real batchUpdate, not delete-and-rewrite.

Insert a new paragraph immediately after the paragraph containing anchor.

The anchor is matched case-insensitively as a substring of the paragraph.

Rich formatting is ON by default. Set rich=False to insert literal text.

Insert a new paragraph immediately before the paragraph containing anchor.

The anchor is matched case-insensitively as a substring of the paragraph.

Rich formatting is ON by default. Set rich=False to insert literal text.

Delete the paragraph(s) containing anchor text.

Deletes ALL paragraphs that contain the anchor string (case-insensitive). If the anchor matches only one paragraph, only that paragraph is deleted.

Append a new paragraph at the end of a Google Doc.

Rich formatting is ON by default. Set rich=False to append literal text.

Apply multiple find→replace operations atomically in a single batchUpdate.

All replacements are applied in one API call (end-of-document first to preserve index validity). Either ALL changes succeed, or none do.

Add a comment anchored to specific text in a Google Doc.

NOTE: The current implementation uses the Drive comments API plus a Docs named range. In the Docs UI this still shows as "Original content deleted" rather than a proper inline comment highlight. The comments ARE readable via docs_read_comments and the Docs 💬 panel.

The next path to investigate is Apps Script automation. The OAuth token must include the script.* scopes, and the Google account must also have the Apps Script API enabled at https://script.google.com/home/usersettings before remote Apps Script project creation/execution will work.

By default the tool also appends the matched anchor text into the comment body so the user can understand what was targeted even though the Docs UI does not render a proper inline highlight with the current API path.

When bookmark_jump=True, the tool also uses a persistent Apps Script bridge (configured via GOOGLE_DOCS_MCP_APPS_SCRIPT_ID) to create a bookmark at the target text, then appends a #bookmark jump URL into the comment body.

Reply to an existing comment on a Google Doc.

Resolve (close) a comment on a Google Doc, optionally with a final reply.

Delete a comment from a Google Doc.

Read all comments on a Google Doc.

Returns each comment with its content, author, anchor status, and whether it's resolved or deleted. Useful for auditing what comments exist and whether they are properly anchored to text.

List Google Docs from Drive, optionally filtered by a search query.

Create a new Google Doc with an optional initial paragraph of text.