@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

``bash npx @suncreation/mcp-google-docs`

`Installation`

`$3`

`json { "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" } } } }`

`$3`

`json { "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`

`$3`


- Read/write documents
- Text formatting (bold, italic, colors)
- Paragraph styling (alignment, spacing)
- Tables, images, page breaks
- Comment management
$3

- Read/write spreadsheets
- Append rows, clear ranges
- Create spreadsheets, add sheets
$3

- List, search, create documents
- Folder management
- Move, copy, rename, delete files
Environment Variables

| Variable | Description | |----------|-------------| |GOOGLE_CLIENT_ID| OAuth Client ID | |GOOGLE_CLIENT_SECRET| OAuth Client Secret | |CREDENTIALS_PATH| Path to credentials.json (alternative to above) | |TOKEN_PATH| Path to save/load token.json | |SERVICE_ACCOUNT_PATH| Path to service account key (for enterprise) | |GOOGLE_IMPERSONATE_USER | Email to impersonate (with service account) |

`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: Addhttp://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

Installation

$3

json
{
  "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"
      }
    }
  }
}

$3

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

Features

$3

- Read/write documents
- Text formatting (bold, italic, colors)
- Paragraph styling (alignment, spacing)
- Tables, images, page breaks
- Comment management

$3

- Read/write spreadsheets
- Append rows, clear ranges
- Create spreadsheets, add sheets

$3

- List, search, create documents
- Folder management
- Move, copy, rename, delete files

Environment Variables

| Variable | Description |
|----------|-------------|
|

GOOGLE_CLIENT_ID

 | OAuth Client ID |
|

GOOGLE_CLIENT_SECRET

 | OAuth Client Secret |
|

CREDENTIALS_PATH

 | Path to credentials.json (alternative to above) |
|

TOKEN_PATH

 | Path to save/load token.json |
|

SERVICE_ACCOUNT_PATH

 | Path to service account key (for enterprise) |
|

GOOGLE_IMPERSONATE_USER | Email to impersonate (with service account) |