google-docs-mcp

MCP server to read, create and edit Google Docs. Built for report/audit workflows: clone a template, fill sections by heading, find/replace placeholders, and read content back for analysis.

Tools (8)

Typical workflow

1. copy_document(template_id, "Client Report — August 2026")
2. find_replace("{{CLIENT}}", "Acme Inc.")
3. find_replace("{{DATE}}", "August 2026")
4. get_document_structure()  → see available headings
5. insert_text_after_heading("TRAFFIC OVERVIEW", report_data)

Setup

1. Create a Google Cloud project (or reuse one) and enable the Google Docs API and Google Drive API (needed for copy_document).
2. Create an OAuth 2.0 Client ID of type "Desktop app" and download it as client_secret.json.
3. If the app is in "Testing" mode, add your Google account as a test user.
4. Install dependencies:

   python3 -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt
   

5. Run the OAuth flow once:

   CLIENT_SECRET_PATH=~/.config/google-docs-mcp/client_secret.json \
     python3 setup_auth.py
   

   This opens a browser — log in and grant access.

MCP client configuration

{
  "mcpServers": {
    "google-docs": {
      "command": "/path/to/.venv/bin/python3",
      "args": ["/path/to/google-docs-mcp/server.py"],
      "env": {
        "GOOGLE_WORKSPACE_TOKEN_PATH": "~/.config/google-docs-mcp/token.json"
      }
    }
  }
}

Notes

• insert_text_after_heading does a case-insensitive substring match, so "traffic" matches "TRAFFIC OVERVIEW".
• copy_document uses the Drive API (files().copy()).
• If the heading isn't found, the response includes available_headings so you can retry with the correct one.

License

MIT — see LICENSE.