@suncreation/mcp-google-docs

MCP server for Google Docs, Sheets & Drive with full formatting support.

Fork of a-bonus/google-docs-mcp with fixed OAuth flow (replaced deprecated OOB with localhost redirect).

Quick Start with npx

npx @suncreation/mcp-google-docs

Related MCP server: @node2flow/google-docs-mcp

Installation

Option 1: Environment Variables (Recommended for npx)

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@suncreation/mcp-google-docs"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "TOKEN_PATH": "/path/to/token.json"
      }
    }
  }
}

Option 2: credentials.json File

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@suncreation/mcp-google-docs"],
      "env": {
        "CREDENTIALS_PATH": "/path/to/credentials.json",
        "TOKEN_PATH": "/path/to/token.json"
      }
    }
  }
}

First Run: OAuth Authentication

On first run, a browser window will open for Google authentication. After approval, token.json is saved for future use.

Features

Google Docs

• Read/write documents

• Text formatting (bold, italic, colors)

• Paragraph styling (alignment, spacing)

• Tables, images, page breaks

• Comment management

Google Sheets

• Read/write spreadsheets

• Append rows, clear ranges

• Create spreadsheets, add sheets

Google Drive

• List, search, create documents

• Folder management

• Move, copy, rename, delete files

Environment Variables

Google Cloud Setup

1. Go to Google Cloud Console

2. Create a project

3. Enable APIs: Google Docs API, Google Sheets API, Google Drive API

4. Create OAuth 2.0 credentials (Desktop app)

5. Important: Add http://localhost:3000/oauth2callback to Authorized redirect URIs

6. Download credentials.json or copy Client ID/Secret

License

MIT - Based on a-bonus/google-docs-mcp