Google Docs
Connects Claude to Google Docs through an OAuth proxy setup, giving you tools to read full document structure or plain text, create new docs, and apply batch edits like inserting text, find and replace, table manipulation, and formatting changes. The architecture is stateless: it handles the OAuth dance with Google on your behalf but stores nothing, just forwards tokens through. Good for workflows where you need Claude to pull info from existing docs (contract Q&A, meeting notes synthesis) or maintain persistent context across sessions by reading and updating a planning log. Pairs with google-drive-mcp for file discovery and permissions. Requires creating OAuth credentials in Google Cloud Console and running the server locally.
- GitHub stars
- 1
- tools
- 33
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 4
- last updated
- Mar 7, 2026
Tools
33 toolsPublic tool metadata for what this MCP can expose to an agent.
GOOGLEDOCS_COPY_DOCUMENTTool to create a copy of an existing Google Document. Use this to duplicate a document, for example, when using an existing document as a template. The copied document will have a default title (e.g., 'Copy of [original title]') if no new title is provided, and will be placed...2 params
Tool to create a copy of an existing Google Document. Use this to duplicate a document, for example, when using an existing document as a template. The copied document will have a default title (e.g., 'Copy of [original title]') if no new title is provided, and will be placed...
document_idstringtitlestringGOOGLEDOCS_CREATE_DOCUMENTCreates a new Google Docs document using the provided title as filename and inserts the initial text at the beginning if non-empty, returning the document's ID and metadata (excluding body content).2 params
Creates a new Google Docs document using the provided title as filename and inserts the initial text at the beginning if non-empty, returning the document's ID and metadata (excluding body content).
textstringtitlestringGOOGLEDOCS_CREATE_DOCUMENT_MARKDOWNCreates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text.2 params
Creates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text.
markdown_textstringtitlestringGOOGLEDOCS_CREATE_FOOTERTool to create a new footer in a Google Document. Use when you need to add a footer, optionally specifying its type and the section it applies to.3 params
Tool to create a new footer in a Google Document. Use when you need to add a footer, optionally specifying its type and the section it applies to.
document_idstringsection_break_locationobjecttypestringHEADER_FOOTER_TYPE_UNSPECIFIED · DEFAULTGOOGLEDOCS_CREATE_FOOTNOTETool to create a new footnote in a Google Document. Use this when you need to add a footnote at a specific location or at the end of the document body.3 params
Tool to create a new footnote in a Google Document. Use this when you need to add a footnote at a specific location or at the end of the document body.
documentIdstringendOfSegmentLocationobjectlocationobjectGOOGLEDOCS_CREATE_HEADERTool to create a new header in a Google Document. Use this tool when you need to add a header to a document, optionally specifying the section it applies to.2 params
Tool to create a new header in a Google Document. Use this tool when you need to add a header to a document, optionally specifying the section it applies to.
createHeaderobjectdocumentIdstringGOOGLEDOCS_CREATE_NAMED_RANGETool to create a new named range in a Google Document. Use this to assign a name to a specific part of the document for easier reference or programmatic manipulation.5 params
Tool to create a new named range in a Google Document. Use this to assign a name to a specific part of the document for easier reference or programmatic manipulation.
documentIdstringnamestringrangeEndIndexintegerrangeSegmentIdstringrangeStartIndexintegerGOOGLEDOCS_CREATE_PARAGRAPH_BULLETSTool to add bullets to paragraphs within a specified range in a Google Document. Use when you need to format a list or a set of paragraphs as bullet points.2 params
Tool to add bullets to paragraphs within a specified range in a Google Document. Use when you need to format a list or a set of paragraphs as bullet points.
createParagraphBulletsobjectdocument_idstringGOOGLEDOCS_DELETE_CONTENT_RANGETool to delete a range of content from a Google Document. Use when you need to remove a specific portion of text or other structural elements within a document.2 params
Tool to delete a range of content from a Google Document. Use when you need to remove a specific portion of text or other structural elements within a document.
document_idstringrangeobjectGOOGLEDOCS_DELETE_FOOTERTool to delete a footer from a Google Document. Use when you need to remove a footer from a specific section or the default footer.3 params
Tool to delete a footer from a Google Document. Use when you need to remove a footer from a specific section or the default footer.
document_idstringfooter_idstringtab_idstringGOOGLEDOCS_DELETE_HEADERDeletes the header from the specified section or the default header if no section is specified. Use this tool to remove a header from a Google Document.3 params
Deletes the header from the specified section or the default header if no section is specified. Use this tool to remove a header from a Google Document.
document_idstringheader_idstringtab_idstringGOOGLEDOCS_DELETE_NAMED_RANGETool to delete a named range from a Google Document. Use when you need to remove a previously defined named range by its ID or name.2 params
Tool to delete a named range from a Google Document. Use when you need to remove a previously defined named range by its ID or name.
deleteNamedRangeobjectdocument_idstringGOOGLEDOCS_DELETE_PARAGRAPH_BULLETSTool to remove bullets from paragraphs within a specified range in a Google Document. Use when you need to clear bullet formatting from a section of a document.3 params
Tool to remove bullets from paragraphs within a specified range in a Google Document. Use when you need to clear bullet formatting from a section of a document.
document_idstringrangeobjecttab_idstringGOOGLEDOCS_DELETE_TABLETool to delete an entire table from a Google Document. Use when you have the document ID and the specific start and end index of the table element to be removed. The table's range can be found by inspecting the document's content structure.5 params
Tool to delete an entire table from a Google Document. Use when you have the document ID and the specific start and end index of the table element to be removed. The table's range can be found by inspecting the document's content structure.
document_idstringsegment_idstringtab_idstringtable_end_indexintegertable_start_indexintegerGOOGLEDOCS_DELETE_TABLE_COLUMNTool to delete a column from a table in a Google Document. Use this tool when you need to remove a specific column from an existing table within a document.2 params
Tool to delete a column from a table in a Google Document. Use this tool when you need to remove a specific column from an existing table within a document.
document_idstringrequestsarrayGOOGLEDOCS_DELETE_TABLE_ROWTool to delete a row from a table in a Google Document. Use when you need to remove a specific row from an existing table.2 params
Tool to delete a row from a table in a Google Document. Use when you need to remove a specific row from an existing table.
documentIdstringtableCellLocationobjectGOOGLEDOCS_GET_CHARTS_FROM_SPREADSHEETTool to retrieve a list of all charts from a specified Google Sheets spreadsheet. Use when you need to get chart IDs and their specifications for embedding or referencing elsewhere, such as in Google Docs.1 params
Tool to retrieve a list of all charts from a specified Google Sheets spreadsheet. Use when you need to get chart IDs and their specifications for embedding or referencing elsewhere, such as in Google Docs.
spreadsheet_idstringGOOGLEDOCS_GET_DOCUMENT_BY_IDRetrieves an existing Google Document by its ID; will error if the document is not found.1 params
Retrieves an existing Google Document by its ID; will error if the document is not found.
idstringGOOGLEDOCS_INSERT_INLINE_IMAGETool to insert an image from a given URI at a specified location in a Google Document as an inline image. Use when you need to add an image to a document programmatically.4 params
Tool to insert an image from a given URI at a specified location in a Google Document as an inline image. Use when you need to add an image to a document programmatically.
documentIdstringlocationobjectobjectSizeobjecturistringGOOGLEDOCS_INSERT_PAGE_BREAKTool to insert a page break into a Google Document. Use when you need to start new content on a fresh page, such as at the end of a chapter or section.2 params
Tool to insert a page break into a Google Document. Use when you need to start new content on a fresh page, such as at the end of a chapter or section.
documentIdstringinsertPageBreakobjectGOOGLEDOCS_INSERT_TABLE_ACTIONTool to insert a table into a Google Document. Use when you need to add a new table at a specific location or at the end of a segment (like document body, header, or footer) in a document.7 params
Tool to insert a table into a Google Document. Use when you need to add a new table at a specific location or at the end of a segment (like document body, header, or footer) in a document.
columnsintegerdocumentIdstringindexintegerinsertAtEndOfSegmentbooleanrowsintegersegmentIdstringtabIdstringGOOGLEDOCS_INSERT_TABLE_COLUMNTool to insert a new column into a table in a Google Document. Use this tool when you need to add a column to an existing table at a specific location.2 params
Tool to insert a new column into a table in a Google Document. Use this tool when you need to add a column to an existing table at a specific location.
document_idstringrequestsarrayGOOGLEDOCS_INSERT_TEXT_ACTIONTool to insert a string of text at a specified location within a Google Document. Use when you need to add new text content to an existing document.3 params
Tool to insert a string of text at a specified location within a Google Document. Use when you need to add new text content to an existing document.
document_idstringinsertion_indexintegertext_to_insertstringGOOGLEDOCS_LIST_SPREADSHEET_CHARTS_ACTIONTool to retrieve a list of charts with their IDs and metadata from a Google Sheets spreadsheet. Use to identify charts available for embedding into Google Docs.2 params
Tool to retrieve a list of charts with their IDs and metadata from a Google Sheets spreadsheet. Use to identify charts available for embedding into Google Docs.
fields_maskstringspreadsheet_idstringGOOGLEDOCS_REPLACE_ALL_TEXTTool to replace all occurrences of a specified text string with another text string throughout a Google Document. Use when you need to perform a global find and replace operation within a document.6 params
Tool to replace all occurrences of a specified text string with another text string throughout a Google Document. Use when you need to perform a global find and replace operation within a document.
document_idstringfind_textstringmatch_casebooleanreplace_textstringsearch_by_regexbooleantab_idsarrayGOOGLEDOCS_REPLACE_IMAGETool to replace a specific image in a document with a new image from a URI. Use when you need to update an existing image within a Google Doc.2 params
Tool to replace a specific image in a document with a new image from a URI. Use when you need to update an existing image within a Google Doc.
document_idstringreplace_imageobjectGOOGLEDOCS_SEARCH_DOCUMENTSSearch for Google Documents using various filters including name, content, date ranges, and more.8 params
Search for Google Documents using various filters including name, content, date ranges, and more.
created_afterstringinclude_trashedbooleanmax_resultsintegermodified_afterstringorder_bystringquerystringshared_with_mebooleanstarred_onlybooleanGOOGLEDOCS_UNMERGE_TABLE_CELLSTool to unmerge previously merged cells in a table. Use this when you need to revert merged cells in a Google Document table back to their individual cell states.2 params
Tool to unmerge previously merged cells in a table. Use this when you need to revert merged cells in a Google Document table back to their individual cell states.
document_idstringtableRangeobjectGOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWNReplaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document.2 params
Replaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document.
document_idstringnew_markdown_textstringGOOGLEDOCS_UPDATE_DOCUMENT_SECTION_MARKDOWNTool to insert or replace a section of a Google Docs document with Markdown content. Use when you need to update only a section of a document by specifying start and optional end indices. Supports full Markdown formatting.4 params
Tool to insert or replace a section of a Google Docs document with Markdown content. Use when you need to update only a section of a document by specifying start and optional end indices. Supports full Markdown formatting.
document_idstringend_indexintegermarkdown_textstringstart_indexintegerGOOGLEDOCS_UPDATE_DOCUMENT_STYLETool to update the overall document style, such as page size, margins, and default text direction. Use when you need to modify the global style settings of a Google Document.4 params
Tool to update the overall document style, such as page size, margins, and default text direction. Use when you need to modify the global style settings of a Google Document.
document_idstringdocument_styleobjectfieldsstringtab_idstringGOOGLEDOCS_UPDATE_EXISTING_DOCUMENTApplies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method.2 params
Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method.
document_idstringeditDocsarrayGOOGLEDOCS_UPDATE_TABLE_ROW_STYLETool to update the style of a table row in a Google Document. Use when you need to modify the appearance of specific rows within a table, such as setting minimum row height or marking rows as headers.2 params
Tool to update the style of a table row in a Google Document. Use when you need to modify the appearance of specific rows within a table, such as setting minimum row height or marking rows as headers.
documentIdstringupdateTableRowStyleobjectSponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GOOGLE_ACCESS_TOKEN*secretGoogle OAuth access token with Docs scope.
MCP_TRANSPORT*Transport type.
GOOGLE_CLIENT_ID*Google OAuth client ID.
GOOGLE_CLIENT_SECRET*secretGoogle OAuth client secret.
Readme
google-documents-mcp
MCP server for Google Docs - read and edit documents.
Use Cases
Document Q&A: "What does the contract say about termination clauses?" → reads the doc and pulls out the relevant section.
Meeting-to-doc workflow: After a call, reads the Gemini transcript plus follow-up Slack discussion, then updates your team charter with the decisions made.
Release announcement: "Draft a blog post about the new feature based on the GitHub PRs and Slack discussions in #proj-awesome" → synthesizes technical changes into user-facing content.
Daily planning with persistent context: Your AI assistant reads a "planning log" doc at the start of each day, asks about yesterday's progress, helps you identify today's priority, then updates the doc with your plan. Context carries over across sessions - it remembers what you said you'd do and can follow up.
(These are just examples - any workflow that needs document reading or editing can use this. Use in combination with google-drive-mcp for finding files, deleting, comments, and sharing permissions.)
Setup
1. Create Google OAuth credentials
Details
- Repository
- github.com/domdomegg/google-documents-mcp
- Website
- github.com/domdomegg/google-documents-mcp#readme
- Package
google-documents-mcp- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active