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.
Public 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 paramsTool 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...
titlestringdocument_idstringGOOGLEDOCS_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 paramsCreates 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 paramsCreates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text.
titlestringmarkdown_textstringGOOGLEDOCS_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 paramsTool 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.
typestringHEADER_FOOTER_TYPE_UNSPECIFIED · DEFAULTdocument_idstringsection_break_locationobjectGOOGLEDOCS_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 paramsTool 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.
locationobjectdocumentIdstringendOfSegmentLocationobjectGOOGLEDOCS_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 paramsTool 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.
documentIdstringcreateHeaderobjectGOOGLEDOCS_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 paramsTool 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.
namestringdocumentIdstringrangeEndIndexintegerrangeSegmentIdstringrangeStartIndexintegerGOOGLEDOCS_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 paramsTool 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.
document_idstringcreateParagraphBulletsobjectGOOGLEDOCS_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 paramsTool 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.
rangeobjectdocument_idstringGOOGLEDOCS_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 paramsTool to delete a footer from a Google Document. Use when you need to remove a footer from a specific section or the default footer.
tab_idstringfooter_idstringdocument_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 paramsDeletes 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.
tab_idstringheader_idstringdocument_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 paramsTool 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.
document_idstringdeleteNamedRangeobjectGOOGLEDOCS_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 paramsTool 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.
rangeobjecttab_idstringdocument_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 paramsTool 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.
tab_idstringsegment_idstringdocument_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 paramsTool 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.
requestsarraydocument_idstringGOOGLEDOCS_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 paramsTool 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 paramsTool 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 paramsRetrieves 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 paramsTool 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.
uristringlocationobjectdocumentIdstringobjectSizeobjectGOOGLEDOCS_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 paramsTool 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 paramsTool 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.
rowsintegerindexintegertabIdstringcolumnsintegersegmentIdstringdocumentIdstringinsertAtEndOfSegmentbooleanGOOGLEDOCS_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 paramsTool 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.
requestsarraydocument_idstringGOOGLEDOCS_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 paramsTool 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_idstringtext_to_insertstringinsertion_indexintegerGOOGLEDOCS_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 paramsTool 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 paramsTool 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.
tab_idsarrayfind_textstringmatch_casebooleandocument_idstringreplace_textstringsearch_by_regexbooleanGOOGLEDOCS_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 paramsTool 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 paramsSearch for Google Documents using various filters including name, content, date ranges, and more.
querystringorder_bystringmax_resultsintegerstarred_onlybooleancreated_afterstringmodified_afterstringshared_with_mebooleaninclude_trashedbooleanGOOGLEDOCS_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 paramsTool 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.
tableRangeobjectdocument_idstringGOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWNReplaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document.2 paramsReplaces 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 paramsTool 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.
end_indexintegerdocument_idstringstart_indexintegermarkdown_textstringGOOGLEDOCS_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 paramsTool 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.
fieldsstringtab_idstringdocument_idstringdocument_styleobjectGOOGLEDOCS_UPDATE_EXISTING_DOCUMENTApplies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method.2 paramsApplies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method.
editDocsarraydocument_idstringGOOGLEDOCS_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 paramsTool 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.
documentIdstringupdateTableRowStyleobjectMCP server for Google Docs - read and edit documents.
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.)
http://localhost:3000/callback to Authorized redirect URIsGOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start
The server runs on http://localhost:3000 by default. Change with PORT=3001.
claude mcp add --transport http google-documents-mcp http://localhost:3000/mcp
This server acts as an OAuth proxy to Google:
graph LR
A[MCP client] <--> B[google-documents-mcp] <--> C[Google OAuth/API]
/.well-known/oauth-authorization-server/register returns the Google OAuth client credentials/authorize redirects to Google, encoding the client's callback URL in state/callback receives the code from Google and forwards to the client's callback/token proxies token requests to Google, injecting client credentials/mcp handles MCP requests, using the bearer token to call Google Docs APIThe server holds no tokens or state - it just proxies OAuth to Google.
| Tool | Description |
|---|---|
document_get_raw | Get full raw JSON structure (all tabs, formatting, headers, footers, styles) |
document_get_text | Get plain text content of all tabs |
document_create | Create a new blank document |
document_batch_update | Apply multiple edits atomically (insert, delete, format, etc.) |
document_append | Append text to end of document |
document_insert | Insert text at a specific index |
document_replace | Find and replace text |
The document_batch_update tool supports these operations:
insertText - Insert text at a locationdeleteContentRange - Delete a range of contentreplaceAllText - Find and replace all occurrencesinsertInlineImage - Insert an imageinsertTable - Create a tableinsertTableRow / insertTableColumn - Add rows/columns to tablesdeleteTableRow / deleteTableColumn - Remove rows/columns from tablesinsertPageBreak - Add a page breakcreateNamedRange / deleteNamedRange - Manage named rangescreateParagraphBullets / deleteParagraphBullets - Manage bullet listsdocuments - Full access to read and edit documentsPull requests are welcomed on GitHub! To get started:
npm installnpm run test to run testsnpm run buildVersions follow the semantic versioning spec.
To release:
npm version <major | minor | patch> to bump the versiongit push --follow-tags to push with tagsGOOGLE_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.