Summary
Connects Claude to Google Docs through Pipeworx's OAuth gateway with six core operations: retrieve formatted or plain text documents, create new docs, and edit existing ones through insert, append, and find-replace actions. Position-based insertions let you target specific locations in a document, while the replace tool handles bulk text substitution. Part of the larger Pipeworx gateway that bundles 250+ data sources, though this can be used standalone. Best suited when you need Claude to draft documents directly in your Google workspace or pull content from existing docs for analysis without manual copy-paste.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
33 tools
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...
Parameters* required
titlestringThe title for the new copied document. If not provided, the title will be 'Copy of [original document's title]'.
document_idstringThe ID of the Google Document to be copied.
GOOGLEDOCS_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).
Parameters* required
textstringInitial text content to insert at the beginning of the new document.
titlestringTitle for the new document, used as its filename in Google Drive.
GOOGLEDOCS_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.
Parameters* required
titlestringThe title for the new Google Docs document.
markdown_textstringThe initial content for the document, formatted as Markdown. Supports various Markdown elements including headings, lists (nested lists are not supported), tables, images (via publicly accessible URLs), blockquotes, code blocks, and text formatting (bold, italic, etc.). If an empty string is provided, the document will be created with only the title. Image URL constraints: URLs must be less than or equal to 2KB in length. Supported image formats: JPEG, PNG, GIF (SVG is not supported).
GOOGLEDOCS_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.
Parameters* required
typestringThe type of footer to create.one of
HEADER_FOOTER_TYPE_UNSPECIFIED · DEFAULTdocument_idstringThe ID of the document to create the footer in.
section_break_locationobjectThe location of the SectionBreak immediately preceding the section whose SectionStyle this footer should belong to. If this is unset or refers to the first section break in the document, the footer applies to the document style.
GOOGLEDOCS_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.
Parameters* required
locationobjectInserts the footnote reference at a specific index in the document. The segmentId within this Location object must be empty as footnotes can only be inserted in the document body.
documentIdstringThe ID of the document to create the footnote in.
endOfSegmentLocationobjectInserts the footnote reference at the end of the document body. The segmentId within this EndOfSegmentLocation object must be empty.
GOOGLEDOCS_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.
Parameters* required
documentIdstringThe ID of the document to create the header in.
createHeaderobjectThe details of the header to create.
GOOGLEDOCS_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.
Parameters* required
namestringThe name for the new named range. Must be 1-256 characters.
documentIdstringThe ID of the document where the named range will be created.
rangeEndIndexintegerThe zero-based end index of the range.
rangeSegmentIdstringOptional. The ID of the header, footer, or footnote. Empty for document body.
rangeStartIndexintegerThe zero-based start index of the range.
GOOGLEDOCS_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.
Parameters* required
document_idstringThe ID of the document to update.
createParagraphBulletsobjectGOOGLEDOCS_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.
Parameters* required
rangeobjectThe range of content to delete. Deleting text across paragraph boundaries may merge paragraphs and affect styles. Certain deletions can invalidate document structure (e.g., part of a surrogate pair, last newline of critical elements, incomplete deletion of tables/equations).
document_idstringThe ID of the document from which to delete content. This ID can be found in the URL of the Google Doc.
GOOGLEDOCS_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.
Parameters* required
tab_idstringThe tab that contains the footer to delete. When omitted, the request is applied to the first tab.
footer_idstringThe ID of the footer to delete. If this footer is defined on DocumentStyle, the reference to this footer is removed, resulting in no footer of that type for the first section of the document. If this footer is defined on a SectionStyle, the reference to this footer is removed and the footer of that type is now continued from the previous section.
document_idstringThe ID of the document to delete the footer from.
GOOGLEDOCS_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.
Parameters* required
tab_idstringThe tab containing the header to delete. When omitted, the request is applied to the first tab.
header_idstringThe ID of the header to delete. If this header is defined on `DocumentStyle`, the reference to this header is removed, resulting in no header of that type for the first section of the document. If this header is defined on a `SectionStyle`, the reference to this header is removed and the header of that type is now continued from the previous section.
document_idstringThe ID of the document from which to delete the header.
GOOGLEDOCS_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.
Parameters* required
document_idstringThe ID of the document.
deleteNamedRangeobjectSpecifies the named range to delete.
GOOGLEDOCS_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.
Parameters* required
rangeobjectThe range of the document from which to delete paragraph bullets. The range is applied to the document body by default. To specify a different segment (e.g. header, footer), include segment_id in the range object.
tab_idstringThe ID of the tab the range is in. If omitted, it applies to the first tab or the singular tab in a single-tab document.
document_idstringThe ID of the document to update.
GOOGLEDOCS_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.
Parameters* required
tab_idstringThe ID of the tab containing the table, if the document uses tabs. If omitted, the action applies to the first tab or the only tab.
segment_idstringThe ID of the segment (e.g., header, footer) containing the table. If omitted or empty, the table is assumed to be in the main document body.
document_idstringThe ID of the Google Document from which the table will be deleted.
table_end_indexintegerThe end index (UTF-16 code unit) of the table's range to be deleted.
table_start_indexintegerThe start index (UTF-16 code unit) of the table's range to be deleted.
GOOGLEDOCS_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.
Parameters* required
requestsarrayA list of requests to be applied to the document.
document_idstringThe ID of the document to delete the table column from.
GOOGLEDOCS_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.
Parameters* required
documentIdstringThe ID of the document.
tableCellLocationobjectThe reference table cell location from which the row will be deleted.
GOOGLEDOCS_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.
Parameters* required
spreadsheet_idstringThe ID of the Google Sheets spreadsheet from which to retrieve charts.
GOOGLEDOCS_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.
Parameters* required
idstringThe unique identifier for the Google Document to be retrieved. This action specifically fetches an existing document and will not create a new one if the ID is not found. You can fetch the documents using GOOGLEDOCS_SEARCH_DOCUMENTS action
GOOGLEDOCS_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.
Parameters* required
uristringThe URI of the image. Must be a publicly accessible direct image URL (no redirects or viewer links like Google Drive preview pages). Images must be less than 50MB, not exceed 25 megapixels, and be in PNG, JPEG, or GIF format (SVG not supported). The URI can be at most 2 kB in length.
locationobjectThe location in the document to insert the image. The index field is required to specify the insertion point.
documentIdstringThe ID of the document to update.
objectSizeobjectThe size of the image. If not specified, the image is rendered at its intrinsic size.
GOOGLEDOCS_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.
Parameters* required
documentIdstringThe ID of the document to update.
insertPageBreakobjectThe details for the insertPageBreak request.
GOOGLEDOCS_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.
Parameters* required
rowsintegerThe number of rows in the table.
indexintegerThe zero-based index where the table will be inserted. If provided, 'location' will be used. If omitted and 'insertAtEndOfSegment' is false or omitted, 'endOfSegmentLocation' will be used for the document body.
tabIdstringThe tab that the location is in. When omitted, the request is applied to the first tab.
columnsintegerThe number of columns in the table.
segmentIdstringThe ID of the header, footer or footnote the location is in. An empty segment ID signifies the document's body.
documentIdstringThe ID of the document to update.
insertAtEndOfSegmentbooleanIf true, inserts the table at the end of the segment (document body, header, or footer specified by segment_id). If false or omitted, and 'index' is not provided, it defaults to inserting at the end of the document body. If 'index' is provided, this field is ignored.
GOOGLEDOCS_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.
Parameters* required
requestsarrayA list of requests to be applied to the document. For this action, it will contain one InsertTableColumnRequest.
document_idstringThe ID of the document to update.
GOOGLEDOCS_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.
Parameters* required
document_idstringThe ID of the document to insert text into.
text_to_insertstringThe string of text to insert.
insertion_indexintegerThe EOL character of the paragraph will be moved to the end of the inserted text. The index where the text will be inserted. The index is zero-based and refers to the UTF-16 code unit. For example, to insert text at the beginning of the document, use an index of 1 (to account for the first paragraph).
GOOGLEDOCS_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.
Parameters* required
fields_maskstringField mask to specify which parts of the spreadsheet and chart resources to include. Example: '''sheets(properties(sheetId,title),charts(chartId,spec(title,altText)))'''default: sheets(properties(sheetId,title),charts(chartId,spec(title,altText)))
spreadsheet_idstringThe ID of the Google Sheets spreadsheet.
GOOGLEDOCS_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.
Parameters* required
tab_idsarrayOptional. A list of specific tab IDs to perform the replacement on. If not provided, replacement occurs on all tabs.
find_textstringThe text to search for in the document.
match_casebooleanIndicates whether the search should be case sensitive.
document_idstringThe ID of the document to update.
replace_textstringThe text that will replace the matched text.
search_by_regexbooleanOptional. If True, the find_text is treated as a regular expression. Defaults to False.default: false
GOOGLEDOCS_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.
Parameters* required
document_idstringThe ID of the document containing the image to replace.
replace_imageobjectThe details of the image replacement request.
GOOGLEDOCS_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.
Parameters* required
querystringSearch query to filter documents. Can search by name (name contains 'report'), full text content (fullText contains 'important'), or use complex queries with operators like 'and', 'or', 'not'. Leave empty to get all documents.
order_bystringOrder results by field. Common options: 'modifiedTime desc', 'modifiedTime asc', 'name', 'createdTime desc'default: modifiedTime desc
max_resultsintegerMaximum number of documents to return (1-1000). Defaults to 10.default: 10
starred_onlybooleanWhether to return only starred documents. Defaults to False.default: false
created_afterstringReturn documents created after this date. Use RFC 3339 format like '2024-01-01T00:00:00Z'.
modified_afterstringReturn documents modified after this date. Use RFC 3339 format like '2024-01-01T00:00:00Z'.
shared_with_mebooleanWhether to return only documents shared with the current user. Defaults to False.default: false
include_trashedbooleanWhether to include documents in trash. Defaults to False.default: false
GOOGLEDOCS_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.
Parameters* required
tableRangeobjectThe table range specifying which cells of the table to unmerge.
document_idstringThe ID of the document to unmerge table cells in.
GOOGLEDOCS_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.
Parameters* required
document_idstringIdentifier of the Google Docs document to update, found in the document's URL.
new_markdown_textstringMarkdown content that will replace the document's entire existing content. Supports standard Markdown features.
GOOGLEDOCS_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.
Parameters* required
end_indexintegerOptional one-based end index of the content to replace; must be greater than or equal to start_index if provided. If end_index is not provided, the content is inserted at the start_index. The index is 1-based to match the Google Docs API.
document_idstringThe ID of the Google Docs document to update.
start_indexintegerOne-based UTF-16 code unit index where to insert or start replacement. The index is 1-based to match the Google Docs API.
markdown_textstringMarkdown content to insert or replace in the document section.
GOOGLEDOCS_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.
Parameters* required
fieldsstringA comma-separated list of fields to update. Use '*' to update all fields in document_style. For example: "pageSize,marginTop,marginBottom".
tab_idstringThe ID of the tab to update the style for. If not provided, the first tab is used.
document_idstringThe ID of the document to update.
document_styleobjectThe DocumentStyle object with the new style settings.
GOOGLEDOCS_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.
Parameters* required
editDocsarrayRequests conforming to the Google Docs API `batchUpdate` method, where each item specifies an operation. For full details and more request types, see https://developers.google.com/docs/api/reference/rest/v1/documents/batchUpdate.
For example, to insert text at the beginning of the document:
[
{
"insertText": {
"text": "This is a new paragraph.\n",
"location": {
"index": 1
}
}
}
]
To delete a paragraph by its index:
[{
"deleteContentRange": {
"range": {
"startIndex": 1,
"endIndex": 20
}
}
}]
To replace all text:
[{
"replaceAllText": {
"containsText": {
"text": "old text"
},
"replaceText": "new text"
}
}]
document_idstringThe unique identifier of the Google Docs document to be updated.
GOOGLEDOCS_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.
Parameters* required
documentIdstringThe ID of the document to update.
updateTableRowStyleobjectmcp-google_docs
Google Docs MCP Pack — read, create, and edit Google Docs via OAuth.
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|---|
docs_get | Retrieve a Google Doc by ID. Returns title, formatted body content, and document structure. |
docs_get_text | Extract plain text from a Google Doc without formatting or structure. Use when you need raw text content only. |
docs_create | Create a new Google Doc with a title. Returns the document ID needed for editing operations. |
docs_insert_text | Insert text at a specific position in a Google Doc (e.g., position 0 for start, position 50 for middle). |
docs_append_text | Add text to the end of a Google Doc. Use when insertion position doesn't matter. |
docs_replace_text | Find and replace all occurrences of text in a Google Doc with new text. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"google_docs": {
"url": "https://gateway.pipeworx.io/google_docs/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Google_docs data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →