@node2flow/google-docs-mcp

MCP server for Google Docs — create, read, edit, format, and manage documents through 26 tools via the Model Context Protocol.

Quick Start

Claude Desktop / Cursor

Add to your MCP config:

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@node2flow/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

HTTP Mode

GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=xxx GOOGLE_REFRESH_TOKEN=xxx npx @node2flow/google-docs-mcp --http

MCP endpoint: http://localhost:3000/mcp

Cloudflare Worker

Available at: https://google-docs-mcp-community.node2flow.net/mcp

POST https://google-docs-mcp-community.node2flow.net/mcp?GOOGLE_CLIENT_ID=xxx&GOOGLE_CLIENT_SECRET=xxx&GOOGLE_REFRESH_TOKEN=xxx

---

Tools (26)

Document (2)

Tool	Description
gdoc_create	Create a new document with a title
gdoc_get	Get document content, structure, headers, footers

Content (5)

Tool	Description
gdoc_insert_text	Insert text at a specific position
gdoc_delete_content	Delete content in a range
gdoc_replace_all_text	Find and replace all occurrences
gdoc_insert_inline_image	Insert image from URL
gdoc_insert_page_break	Insert a page break

Text Formatting (2)

Tool	Description
gdoc_update_text_style	Bold, italic, underline, font, colors, links
gdoc_update_paragraph_style	Alignment, spacing, headings, indentation

Lists (2)

Tool	Description
gdoc_create_bullets	Create bulleted or numbered lists
gdoc_delete_bullets	Remove bullets from paragraphs

Tables (7)

Tool	Description
gdoc_insert_table	Insert a new table
gdoc_insert_table_row	Add a row to a table
gdoc_insert_table_column	Add a column to a table
gdoc_delete_table_row	Remove a table row
gdoc_delete_table_column	Remove a table column
gdoc_merge_table_cells	Merge cells in a table
gdoc_unmerge_table_cells	Unmerge previously merged cells

Headers & Footers (4)

Tool	Description
gdoc_create_header	Create a document header
gdoc_create_footer	Create a document footer
gdoc_delete_header	Delete a header
gdoc_delete_footer	Delete a footer

Sections & Named Ranges (3)

Tool	Description
gdoc_insert_section_break	Insert a section break (next page or continuous)
gdoc_create_named_range	Create a named range to bookmark content
gdoc_delete_named_range	Delete a named range (keeps the content)

Advanced (1)

Tool	Description
gdoc_batch_update	Raw batchUpdate for any combination of operations

---

Index System

Google Docs uses 0-based character indices:

Index 0    → Document root (not usable for content)
Index 1    → Start of body content
Index N    → End of body (from gdoc_get response)

Important: Always call gdoc_get first to find current indices. When making multiple edits, process from end to start to avoid index shifts.

---

Configuration

Parameter	Required	Description
GOOGLE_CLIENT_ID	Yes	OAuth 2.0 Client ID from Google Cloud Console
GOOGLE_CLIENT_SECRET	Yes	OAuth 2.0 Client Secret
GOOGLE_REFRESH_TOKEN	Yes	Refresh token (obtained via OAuth consent flow)

Getting Your Credentials

1. Go to Google Cloud Console
2. Create a project → Enable Google Docs API
3. Create OAuth 2.0 Client ID (Desktop app type)
4. Use the OAuth Playground or your app to get a refresh token with scope https://www.googleapis.com/auth/documents

OAuth Scopes

Scope	Access
documents	Full read/write access
documents.readonly	Read-only access

---

License

MIT License - see LICENSE

Copyright (c) 2026 Node2Flow

Links

• npm Package
• Google Docs API
• MCP Protocol
• Node2Flow