Skip to main content
Google Docs is the go-to collaborative document editor. The Google Docs MCP server lets you search, read, create, and update documents using natural language - including rich text formatting with Markdown and HTML.

What Can It Do?

  • Search documents in Google Drive by keyword
  • Read document content including body text, lists, images, footnotes, headers, footers, and styles
  • Create new documents with plain text, Markdown, or HTML content
  • Update existing documents by appending, prepending, replacing, or inserting content
  • Manage tables by inserting new tables and updating individual cells
  • Navigate multi-tab documents by listing and reading individual tabs

Where to Use It

Add Google Docs as a tool to any agent. The agent can then search and edit your documents conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add toolsConnect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Google Docs tools. This gives you the flexibility of an agent within a deterministic workflow.

As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Read the full content of a Google Doc”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

Available Tools

Read Tools

ToolDescription
Search DocsSearch for Google Docs in Drive by keyword
Read DocRead content from a Google Doc including body, lists, inline objects, footnotes, headers, footers, and styles. Supports reading specific tabs in multi-tab documents
List TabsList all tabs in a Google Doc with their IDs and titles

Write Tools

ToolDescription
Create DocCreate a new Google Doc with content in plain text, Markdown, or HTML format
Update DocUpdate content in an existing Google Doc. Supports append, prepend, replace, insert at index, and find-and-replace operations. Content can be plain text, Markdown, or HTML
Insert TableInsert a table into a Google Doc with optional data and header styling
Update Table CellUpdate the content of a specific table cell
Create Doc and Update Doc support a content_format parameter with three options: plain (default), markdown (CommonMark), and html (rich formatting including bold, italic, colors, headings, lists, tables, code blocks, and images). When using Markdown or HTML, manual style parameters are ignored.

Example Prompts

Use these with your agent or in the Agent Node: Search for documents:
Search for Google Docs matching "quarterly report"
Read a document:
Read the full content of this Google Doc including all tabs
Create a document with Markdown:
Create a new Google Doc titled "Sprint Retrospective" with markdown content including headings and bullet points
Create a document with HTML:
Create a new Google Doc titled "Styled Report" with HTML content including bold headings, colored text, and a bulleted list
Append content:
Append a new section to this Google Doc with a summary in markdown format
Find and replace:
Find all occurrences of "DRAFT" and replace with "FINAL" in this document
Insert a table:
Insert a 4x3 table with a header row containing Name, Status, and Due Date
List tabs:
List all tabs in this Google Doc with their IDs and titles

Troubleshooting

IssueSolution
Agent not finding the right documentUse specific document titles or IDs
Action not completingCheck that you’ve authenticated and have edit access to the document
Unexpected resultsThe agent may chain multiple tools (e.g., searching first, then reading content). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Rich text not renderingMake sure to set content_format to markdown or html when using formatted content
Agents are smart enough to chain multiple API calls together. For example, asking “Find and update my meeting notes” will search first, then update the content. If results seem off, check the agent’s step-by-step reasoning.

Need Help?


Use this integration directly in Claude or Cursor. Connect remotely via the Google Docs MCP server using your Gumloop credentials.