Gogcli Mcp

io.github.chrischall由 GitHub 账号 chrischall 发布v4.12.0更新于 Nov 11, 2026

Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets

概览

AI 生成的概览

本地 MCP 服务器,通过 gogcli 为助手提供 116 个工具,用于读取和管理 Google Workspace 数据,如表格、文档、Gmail、日历和云端硬盘。

可以做什么
  • 读取、创建、更新、追加、清空 Google 表格并执行查找替换,以及读取、创建和写入文档
  • 搜索、读取、发送和回复 Gmail,并列出、创建、更新、删除和回复日历事件
  • 列出、搜索、移动、重命名、共享、删除云端硬盘文件并提取文本,导出或读取幻灯片
  • 管理 Classroom 课程、名单、作业与提交,以及 Chat 空间、会话串、消息和表情回应
  • 运行 Apps Script 函数与部署,管理任务和联系人,并通过通用 Discovery 接口调用任意 Google API
  • 查看授权状态与服务,并为托管部署创建签名上传槽位以交付文件
适用场景
适合希望助手直接操作 Google Workspace 账号的场景,例如编辑电子表格和文档、处理邮件、安排日程或整理云端硬盘文件,可在本机的 Claude Desktop 或 Claude Code 中使用。
运行要求
仅限桌面端,通过 stdio 在本机运行。需要 Node.js 22+,并安装和授权 gogcli(例如通过 brew 安装并执行 gog auth add)。GOG_ACCOUNT 指定 Google 账号;可选变量 GOG_PATH、GOG_READONLY、GOG_TIMEZONE、DISPLAY_TZ 和 GOG_GMAIL_TRUSTED_DOMAINS 用于调整行为。
安装前请注意
项目自述由 AI 编码代理构建并维护,建议先审查代码和工具权限。许多工具会写入、发送、共享或删除数据,包括 Gmail 发送以及云端硬盘共享和删除;可设置 GOG_READONLY 阻止变更请求。它操作真实的 Google 账号,且 GOG_GMAIL_TRUSTED_DOMAINS 会改变哪些外部收件人不触发审计提醒。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Gogcli Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

gogcli-mcp

[!WARNING] AI-developed project. This codebase was built and is actively maintained by Claude Code. Review all code and tool permissions before use.

Base Model Context Protocol server that gives Claude access to Google Workspace via gogcli. Includes 116 tools across 13 services: Sheets, Docs, Gmail, Calendar, Drive, Slides, Classroom, Chat, Apps Script, Tasks, Contacts, the generic Discovery API escape hatch, and Auth — plus hosted file uploads.

For extended Sheets or Docs support, see gogcli-mcp-sheets and gogcli-mcp-docs.

Requirements

  • gogcli installed and authenticated
  • Node.js 22+
bash
brew install gogcligog auth add [email protected]

Installation

bash
npm install -g gogcli-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Claude Code

bash
claude mcp add gogcli-mcp -- gogcli-mcp

Tools (116)

ServiceToolsIncludes
Sheets8get, update, append, clear, metadata, create, find-replace, run
Docs7info, cat, create, write, find-replace, structure, run
Gmail6search, get, send, reply, reply-all, run
Calendar7events, get, create, update, delete, respond, run
Drive11ls, search, get, mkdir, rename, move, delete, share, extract-text, read-bytes, run
Slides7export, info, create, copy, list-slides, read-slide, run
Classroom25courses, students, teachers, roster, coursework, submissions (grade/return/turn-in/reclaim), announcements, topics, invitations, profile, run
Chat13spaces list/find/create, threads list, messages list/search/send, dm send/space, reactions list/create/delete, run
Apps Script8get, content, pull, create, deployments, versions, run-function, run
Tasks7lists, list, get, add, done, delete, run
Contacts5search, list, get, create, run
API3list, describe, call
Auth8list, status, health, services, add, add-url, add-complete, run
Upload1slots — signed upload URLs so a hosted caller can hand over a file (see Hosted file uploads)

All tools accept an optional account parameter to target a specific Google account.

Hosted file uploads

On a hosted deployment (mcp-host) the server shares no filesystem with you, so a path like attach, localPath, file or image names a file on the server and is refused with an explanation. To hand the server a file you hold:

  1. Call gog_upload_slots with files: [{ filename: "photo.jpg" }] (up to 10). It returns one signed upload slot per file, each with a ready curl command.
  2. PUT each file to its uploadUrl (the Content-Type must be the slot's mimeType; the URL expires after 30 minutes).
  3. Pass the slots' blobKeys to the tool that takes the file.

Each file is held to 25 MiB. It is deleted from the upload store once that call succeeds, and kept if the call fails so a retry can reuse the same keys. On a gated send (gog_gmail_send, gog_gmail_reply, gog_gmail_reply_all, gog_chat_messages_send) the confirmation preview reads the file without deleting it and binds its SHA-256, so a file re-uploaded between the preview and the approval is refused rather than sent unseen.

blobKeys is accepted by gog_gmail_send, gog_gmail_reply, gog_gmail_reply_all and gog_chat_messages_send here, and by the Gmail drafts tools and gog_gmail_import (gogcli-mcp-gmail), gog_drive_upload (gogcli-mcp-drive), the Slides image tools (gogcli-mcp-slides) and the Docs image tools (gogcli-mcp-docs). For a small file, attachInline (base64 in the call, up to 8 MiB) still works on any deployment. On a local install gog_upload_slots refuses: pass a path instead.

License

MIT

来源:packages/gogcli-mcp/README.md,提交 4302bf8

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

23
  1. v4.12.0最新Nov 11, 2026
  2. v4.10.0Nov 7, 2026
  3. v4.9.1Nov 5, 2026
  4. v4.8.1Oct 16, 2026
  5. v4.8.0Oct 12, 2026
  6. v4.7.1Oct 10, 2026
  7. v4.7.0Oct 7, 2026
  8. v4.6.3Oct 5, 2026
  9. v4.6.2Oct 5, 2026
  10. v4.6.1Oct 3, 2026
  11. v4.6.0Oct 2, 2026
  12. v4.5.2Sep 28, 2026
  13. v4.5.1Sep 25, 2026
  14. v4.5.0Sep 24, 2026
  15. v4.3.0Sep 23, 2026
  16. v4.2.5Sep 22, 2026
  17. v4.2.4Sep 21, 2026
  18. v4.2.3Sep 21, 2026
  19. v4.2.0Sep 20, 2026
  20. v4.1.0Sep 20, 2026
  21. v4.0.1Sep 18, 2026
  22. v3.0.0Sep 17, 2026
  23. v2.30.0Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分