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

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

A
license - permissive license
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/node2flow-th/google-docs-mcp-community'

If you have feedback or need assistance with the MCP directory API, please join our Discord server