google-docs-mcp-server

Google Docs MCP 服务

一个适用于 Google Docs 的 Model Context Protocol 服务，完整支持标签页——大多数现有服务都会在这方面出错或完全忽略。

使用 Google 服务账号进行全域委派，因此无需 OAuth 同意屏幕即可在 Workspace 组织中运行。

功能

工具	描述
list_tabs	列出文档中的所有标签页（包括嵌套标签页）
read_document	将一个或所有标签页作为 Markdown 读取，并保留正确的标题级别
get_document_info	轻量级元数据：标题、ID、链接、标签页列表
create_document	创建文档，可选择添加初始文本
append_text	在指定标签页末尾追加文本
insert_text	在标签页的字符索引处插入文本
replace_text	在标签页（或整个文档）中查找并替换
batch_update	完整的 batchUpdate 访问权限——格式、表格、图片、样式
list_documents	按名称在 Drive 中搜索文档

所有针对标签页的工具都接受 tab_id 或 tab_title（不区分大小写）。batch_update 工具会自动将 tabId 注入请求，因此你无需手动添加。

为什么要开发此项目

Google Docs 自 2024 年末起便支持标签页，但大多数 MCP 服务要么：

• 完全忽略标签页（只读取第一个标签页）
• 不使用 includeTabsContent=True，因此无法查看标签页内容
• 无法处理嵌套标签页

此服务可以正确处理上述所有情况，并将内容转换为保留正确标题结构的 Markdown。

安装

pip install google-docs-mcp-server

也可以使用 uv 直接运行：

uvx google-docs-mcp-server

前提条件

• Python 3.11+
• 具备全域委派权限的 Google Cloud 服务账号

设置

1. 创建 GCP 服务账号

1. 前往 Google Cloud Console 并创建（或选择）一个项目
2. 启用 Google Docs API 和 Google Drive API
3. 在 IAM & Admin > Service Accounts 下创建服务账号
4. 创建 JSON 密钥并下载

2. 启用全域委派

1. 在 GCP 的服务账号详情页中，启用 Domain-wide Delegation 并记下 Client ID
2. 前往 Google Workspace Admin > Security > API Controls > Domain-wide Delegation
3. 使用以下范围添加 Client ID：

   https://www.googleapis.com/auth/documents
   https://www.googleapis.com/auth/drive.readonly
   

3. 配置 MCP 客户端

将以下内容添加到 MCP 配置中（例如 ~/.claude/mcp.json 或 .mcp.json）：

{
  "mcpServers": {
    "google-docs": {
      "command": "uvx",
      "args": ["google-docs-mcp-server"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/your-service-account-key.json",
        "SUBJECT_EMAIL": "[email protected]"
      }
    }
  }
}

SUBJECT_EMAIL 是服务账号要模拟的 Workspace 用户。

环境变量

变量	必需	描述
SERVICE_ACCOUNT_PATH	是	服务账号 JSON 密钥文件的路径
SUBJECT_EMAIL	是	要模拟的 Workspace 用户的电子邮件地址

许可证

MIT