MCP Google Docs

English | 中文

English

Lightweight MCP Server for querying, reading, and modifying Google Drive documents and spreadsheets.

Setup

1. Create Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project
3. Enable Google Drive API, Google Docs API, Google Sheets API
4. Create OAuth 2.0 credentials (Desktop app type)
5. Save your Client ID and Client Secret

2. Configure MCP Client

Add to your Claude Desktop config:

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "mcp-google-docs"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

3. First Use

Call auth_login tool, browser will open Google authorization page.

Tools

| Tool | Description | |------|-------------| | auth_login | OAuth login | | auth_status | Check auth status | | gdrive_list | List files | | gdrive_search | Search files | | gdrive_info | Get file info | | gdocs_read | Read document | | gdocs_insert | Insert text | | gdocs_append | Append text | | gdocs_replace | Find and replace | | gsheets_info | Get spreadsheet info | | gsheets_read | Read sheet | | gsheets_update | Update cells | | gsheets_batch_update | Batch update | | gsheets_append_row | Append row | | gsheets_append_rows | Append multiple rows at once | | gsheets_insert_rows | Insert empty rows at position |

Prompt Template

## Google Docs MCP Rules

### Workflow
1. Run auth_login first if not authenticated
2. Use gdrive_search or gdrive_list to find files
3. Use read/update tools to operate

### Required
- Always read before modifying
- Use batch_update for bulk operations

### Forbidden
- Never guess file IDs, always search first
- Never update more than 100 cells at once

中文

轻量级 MCP Server，支持查询、阅读、修改 Google Drive 中的文档和表格。

安装配置

1. 创建 Google Cloud 项目

1. 访问 Google Cloud Console
2. 创建新项目
3. 启用 Google Drive API、Google Docs API、Google Sheets API
4. 创建 OAuth 2.0 凭据（桌面应用类型）
5. 记录 Client ID 和 Client Secret

2. 配置 MCP 客户端

在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "mcp-google-docs"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

3. 首次使用

调用 auth_login 工具，浏览器会弹出 Google 授权页面，授权后即可使用。

工具列表

| 工具 | 说明 | |------|------| | auth_login | OAuth 授权登录 | | auth_status | 检查授权状态 | | gdrive_list | 列出文件 | | gdrive_search | 搜索文件 | | gdrive_info | 获取文件信息 | | gdocs_read | 读取文档 | | gdocs_insert | 插入文本 | | gdocs_append | 追加文本 | | gdocs_replace | 查找替换 | | gsheets_info | 获取表格信息 | | gsheets_read | 读取表格 | | gsheets_update | 更新单元格 | | gsheets_batch_update | 批量更新 | | gsheets_append_row | 追加行 | | gsheets_append_rows | 批量追加多行 | | gsheets_insert_rows | 在指定位置插入空行 |

使用提示词

## Google Docs MCP 使用规则

### 流程
1. 首次使用先调用 auth_login 授权
2. 用 gdrive_search 或 gdrive_list 找到目标文件
3. 用对应的 read/update 工具操作

### 强制
- 修改前必须先读取确认内容
- 批量操作使用 batch_update

### 禁止
- 不要猜测文件ID，必须先搜索
- 不要一次修改超过100个单元格

License

MIT