gogcli-mcp

一个包含 6 个 MCP 服务器的单体仓库（monorepo），用于封装 gogcli 工具，实现 Google Workspace 自动化：

• gogcli-mcp — 以 Sheets 为核心功能的聚合包（同时暴露部分 Docs 和 Drive 辅助工具）
• gogcli-mcp-docs — Google Docs：创建、读取、编辑、查找替换、评论管理
• gogcli-mcp-sheets — Google Sheets：单元格操作、区域管理、公式、图表、命名区域
• gogcli-mcp-slides — Google Slides：演示文稿与幻灯片内容创作
• gogcli-mcp-drive — Google Drive：搜索、上传、下载、权限管理
• gogcli-mcp-classroom — Google Classroom：课程管理、作业发布、作业提交、班级名单

全部 6 个服务器共享同一套认证机制——它们均读取你本地机器上 gogcli 的账户配置（通过 gogcli auth add 和 gogcli auth run 完成）。

安装（按子包单独安装）

每个子包均作为独立的 npm 模块发布。请按需安装所需模块：

{
  "mcpServers": {
    "gogcli-docs": {
      "command": "npx",
      "args": ["-y", "gogcli-mcp-docs"],
      "env": { "GOG_ACCOUNT": "you@example.com" }
    },
    "gogcli-sheets": {
      "command": "npx",
      "args": ["-y", "gogcli-mcp-sheets"]
    }
  }
}

或通过聚合包一键安装全部功能：

{ "mcpServers": { "gogcli": { "command": "npx", "args": ["-y", "gogcli-mcp"] } } }

认证

要求已安装并完成认证的 gogcli：

gogcli auth add  # 在浏览器中启动 OAuth 流程，完成 Google 账户授权
gogcli auth list

若存在多个账户，请在 MCP 环境中设置 GOG_ACCOUNT=you@example.com；仅当 gogcli 未加入系统 PATH 时，才需额外设置 GOG_PATH。

工具

每个子包各自暴露一组专属工具，命名采用统一前缀（如 gog_docs_*、gog_sheets_* 等）。完整工具列表请参阅各子包目录下的 SKILL.md 文件。

说明

• 全部 6 个服务器共用同一个 gogcli 二进制文件——只需认证一次。
• 本文档为顶层技能说明；各 API 的详细能力定义位于 packages/*/SKILL.md 中对应的兄弟技能文档内。