Gdocs Server

An MCP (Model Context Protocol) server for reading and editing Google Docs.

Tools

• read_document — read the full text content of a Google Doc
• edit_document — replace the full content of a Google Doc
• append_to_document — add content to the end of a Google Doc
• insert_after_heading — insert content after a named heading
• style_preserving_rewrite — rewrite a doc's content while preserving its existing paragraph/text styles
• debug_styles — dump the raw, unprocessed per-paragraph style data for a doc, straight from the Docs API

Setup

1. Create a Google Cloud project, enable the Google Docs API, and create an OAuth 2.0 Client ID (Desktop app type). Download the client secret JSON and save it in this directory as credentials.json.
2. Install dependencies into a virtualenv:

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

3. Run the one-time auth flow to generate token.json:

   ./venv/bin/python auth.py
   

4. Point your MCP client at server.py (e.g. via ./venv/bin/python server.py).

credentials.json and token.json are gitignored — never commit them, they grant access to your Google account.