gogcli-mcp-docs

Name: gogcli-mcp-docs
Author: chrischall

本地服务

github.com/chrischall生产力14 天前更新

代码仓库

关于 gogcli-mcp-docs

gogcli-mcp-docs 是通过 gogcli 操作 Google Docs 的 MCP 服务，面向需要自动处理文档的 Claude 用户。它提供文档编辑、格式设置、导出及评论管理工具，并包含认证和基础文档操作。

主要功能

01文档读取、创建与编辑
02插入、追加及删除内容
03设置字符与段落格式
04导出多种文档格式
05列出并管理评论

适用场景

01批量修改 Google Docs 文档
02为文档添加格式和评论
03将文档导出为 PDF 或 DOCX

MCP 相关

该 MCP 服务向 MCP 客户端提供 Google Docs 操作工具，涵盖认证、基础文档操作，以及编辑、导出和评论管理。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "chrischall-gogcli-mcp-docs": {
      "command": "npx",
      "args": [
        "-y",
        "gogcli-mcp-docs"
      ],
      "env": {
        "GOG_ACCOUNT": "<GOG_ACCOUNT>",
        "GOG_PATH": "<GOG_PATH>",
        "DISPLAY_TZ": "<DISPLAY_TZ>",
        "GOG_READONLY": "<GOG_READONLY>",
        "GOG_TIMEZONE": "<GOG_TIMEZONE>"
      }
    }
  }
}

启动命令npx -y gogcli-mcp-docs

需要配置的环境变量

GOG_ACCOUNTEmail address of the Google account to use (matches gogcli auth)

GOG_PATHOverride path to the gogcli binary (auto-discovered otherwise)

DISPLAY_TZzone for *Display fields and for interpreting naive gog values; defaults to America/New_York

GOG_READONLYblock all mutating gog API requests (injects gog's --readonly); set to 0/false/no/off (or unset) to allow writes

GOG_TIMEZONEzone gog formats naive dates in; unset, runner.ts hands gog DISPLAY_TZ so the two cannot diverge

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmgogcli-mcp-docs4.8.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

gogcli-mcp-docs

警告

由 AI 开发的项目。 此代码库由 Claude Code 构建并持续维护。使用前请检查所有代码和工具权限。

通过 gogcli 提供扩展版 Google Docs MCP 服务。包含身份验证工具，以及另外 18 个专用 Docs 工具，用于编辑、导出、评论等。

要求

已安装并完成身份验证的 gogcli
Node.js 22+

brew install gogcli
gog auth add [email protected] --services docs,drive

安装

npm install -g gogcli-mcp-docs

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gogcli-docs": {
      "command": "gogcli-mcp-docs",
      "env": {
        "GOG_ACCOUNT": "[email protected]"
      }
    }
  }
}

Claude Code

claude mcp add gogcli-docs -- gogcli-mcp-docs

额外的 Docs 工具（18 个）

另外还提供 5 个身份验证工具和 7 个基础 Docs 工具（info、cat、create、write、find-replace、structure、run）。

工具	说明
`gog_docs_append`	在文档末尾追加文本或 Markdown
`gog_docs_copy`	复制文档
`gog_docs_delete`	按字符索引范围删除内容
`gog_docs_edit`	查找并替换，可控制是否区分大小写
`gog_docs_export`	导出为 PDF、TXT、HTML、DOCX、RTF、ODT 或 EPUB
`gog_docs_format`	应用字符／段落格式（粗体、颜色、对齐方式等）
`gog_docs_insert`	在指定位置插入文本
`gog_docs_list_tabs`	列出所有文档标签页
`gog_docs_read`	以纯文本或原始 JSON 格式读取文档
`gog_docs_sed`	使用类似 sed 的正则表达式流式编辑
`gog_docs_trash`	将文档移至 Drive 垃圾箱
`gog_docs_update`	在指定位置更新文档内容
`gog_docs_comments_list`	列出评论（未解决或已解决），可选包含每条评论的标签页和索引范围
`gog_docs_comments_get`	获取评论及其回复
`gog_docs_comments_add`	添加评论，可选附带引用文本
`gog_docs_comments_reply`	回复评论
`gog_docs_comments_resolve`	解决评论
`gog_docs_comments_delete`	删除评论

已知限制：`gog_docs_append` 使用 `markdown: true` 时

这些问题出在 gogcli 上游的 Markdown → Docs 转换器中；此封装程序只是原样传递 --markdown。上游问题跟踪：

现象	解决方法	上游
一次调用中有 3 个或更多表格时，第 3 个表格前段落末尾的标点顺序会错乱	拆分为多次调用，每次不超过 2 个表格	openclaw/gogcli#607
表格单元格中的行内 `bold` / `italic` / `code` 会按字面字符显示	先插入纯文本单元格内容，再通过 `gog_docs_format` 应用格式	openclaw/gogcli#608
表头为空的表格会将最后一行数据泄漏为字面的竖线文本	始终提供非空表头行	openclaw/gogcli#609