Skip to main content
Glama
node2flow-th

@node2flow/google-docs-mcp

by node2flow-th

@node2flow/google-docs-mcp

npm version License: MIT

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

Related MCP server: LLM2Docs (Unofficial)

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

Related MCP Connectors

Related MCP Servers