# @suncreation/mcp-google-docs

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

> Fork of [a-bonus/google-docs-mcp](https://github.com/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

### Option 1: Environment Variables (Recommended for npx)

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

### Option 2: credentials.json File

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

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

| 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](https://console.cloud.google.com/)
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](https://github.com/a-bonus/google-docs-mcp)