Skip to content
MCP server

Gdocs MCP

Edit Google Docs by text snippet, review tracked changes and manage comments from an agent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.0
Listing updated
3 days ago

About Gdocs MCP

Gdocs MCP is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Where many Google Docs connectors pull down a flat string and push a new one back, this server keeps tracked changes and comment threads intact. Edits are addressed by finding a unique snippet of text, the way a local file edit works, and integer indices are never exposed. An edit can also be submitted as a suggestion for a person to accept in Docs.

Pending suggestions are read back as the change inside its sentence, for example "Pay within [30→45] days", and each can be accepted or rejected on its own. Comment threads can be read with author, time and anchored text, replied to, resolved, or added on quoted text. A doc's tabs behave like sub-files, and several Google accounts can be authorised at once.

It is installed from npm and needs a Google Cloud OAuth client you create yourself. The project documents what Google's API cannot do, such as equations and page numbers, and the server refuses those instead of failing late. Nineteen tools in total, TypeScript, MIT licence.

Install

Run in a terminal

claude mcp add gdocs-mcp -- npx -y @dasasian/gdocs-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gdocs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dasasian/gdocs-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gdocs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dasasian/gdocs-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gdocs-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dasasian/gdocs-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gdocs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dasasian/gdocs-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gdocs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dasasian/gdocs-mcp"
      ]
    }
  }
}

What it does

Snippet-based editing
Match a unique piece of text and rewrite it, with no index handling.
Suggestion review
List pending tracked changes and accept or reject each one separately.
Comment management
Read threads, reply, resolve and comment on quoted text.
Tabs as sub-files
List, rename, reorder and nest a document's tabs like a folder.
Multiple Google accounts
Authorise several accounts and choose a default per project.
Honest limits
Refuses unsupported operations such as equations and page numbers and says what to write instead.

Good for

  • Review a contract's tracked changes and accept the typo fixes
  • Fill a proposal template while keeping its letterhead and styling
  • Reply to and resolve open comment threads in a draft
  • Publish a folder of markdown files as a Drive tree
  • Audit many documents for style drift

Pricing

Open source

MIT licensed, free to use with your own Google Cloud OAuth client

Prices change. Check dasasian.com before you buy.

Gdocs MCP FAQ

How do I install it?

Run npm install -g @dasasian/gdocs-mcp, then add an account with gdocs-mcp add-account.

Do I need my own Google credentials?

Yes. You create a Desktop-app OAuth client in Google Cloud once, which keeps the credentials yours and avoids app verification.

Can the agent make suggestions instead of direct edits?

Yes. An edit can be submitted as a suggestion for a person to accept in Docs.

What licence is it under?

MIT.

Is Gdocs MCP free?

Yes. Gdocs MCP is open source, so you can use and self-host it for free.

How do I add Gdocs MCP to Claude Code?

Run this command in your terminal: claude mcp add gdocs-mcp -- npx -y @dasasian/gdocs-mcp

What are the best alternatives to Gdocs MCP?

The closest alternatives to Gdocs MCP are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

Alternatives to Gdocs MCP

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents