# Gdocs MCP

> Gdocs MCP is an open-source MCP server for files and documents. Edit Google Docs by text snippet, review tracked changes and manage comments from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://dasasian.com/gdocs-mcp
- **Repository:** https://github.com/dasasian/gdocs-mcp
- **MCP Registry name:** io.github.dasasian/gdocs-mcp
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gdocs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dasasian/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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/gdocs-mcp
