gogcli-mcp

Name: gogcli-mcp
Author: chrischall

本地服务

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

代码仓库

关于 gogcli-mcp

gogcli-mcp 通过 gogcli 将 Claude 连接到 Google Workspace，适合需要跨多个服务处理工作的用户。工具涵盖表格、邮件、日历、文件、Classroom 等，并提供通用 API 调用入口和账户选择。

主要功能

01覆盖 13 项服务的 115 个工具
02读取和编辑 Google Sheets 与 Docs
03搜索 Gmail 并发送邮件
04管理日历事件和 Drive 文件
05支持 Classroom、Chat、Slides 和 Tasks
06指定 Google 账户操作

适用场景

01更新表格并追加行
02搜索邮件并发送回复
03管理日历事件和 Drive 文件

MCP 相关

它将由 gogcli 支持的 Google Workspace 操作作为 MCP 工具提供给 Claude，包括各服务专用工具和通用 API 调用入口。工具可指定 Google 账户。

配置

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

mcp.json · 通用配置

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

启动命令npx -y gogcli-mcp

需要配置的环境变量

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_GMAIL_TRUSTED_DOMAINSadditional domains excluded from external-recipient audit alerts

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-mcp4.8.1stdio

工具

115

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

参数	类型	必填	说明
all	boolean	否	包含所有 Discovery API（包括预览版和较少使用的 API），而非精选的默认集合
account	string	否	要使用的 Google 账号邮箱，例如 [email protected] — 必须是完整地址，不能只是用户名。覆盖 GOG_ACCOUNT 环境变量。省略时使用唯一配置的账号。

详细介绍

gogcli-mcp

警告

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

基础 Model Context Protocol 服务，通过 gogcli 为 Claude 提供访问 Google Workspace 的能力。包含 13 项服务的 115 个工具：Sheets、Docs、Gmail、Calendar、Drive、Slides、Classroom、Chat、Apps Script、Tasks、Contacts、通用 Discovery API 逃生通道，以及 Auth。

如需扩展 Sheets 或 Docs 支持，请参阅 gogcli-mcp-sheets 和 gogcli-mcp-docs。

要求

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

brew install gogcli
gog auth add [email protected]

安装

npm install -g gogcli-mcp

Claude Desktop

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

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

Claude Code

claude mcp add gogcli-mcp -- gogcli-mcp

工具（115 个）

服务	工具	包含
Sheets	8	get、update、append、clear、metadata、create、find-replace、run
Docs	7	info、cat、create、write、find-replace、structure、run
Gmail	6	search、get、send、reply、reply-all、run
Calendar	7	events、get、create、update、delete、respond、run
Drive	11	ls、search、get、mkdir、rename、move、delete、share、extract-text、read-bytes、run
Slides	7	export、info、create、copy、list-slides、read-slide、run
Classroom	25	courses、students、teachers、roster、coursework、submissions（grade/return/turn-in/reclaim）、announcements、topics、invitations、profile、run
Chat	13	spaces list/find/create、threads list、messages list/search/send、dm send/space、reactions list/create/delete、run
Apps Script	8	get、content、pull、create、deployments、versions、run-function、run
Tasks	7	lists、list、get、add、done、delete、run
Contacts	5	search、list、get、create、run
API	3	list、describe、call
Auth	8	list、status、health、services、add、add-url、add-complete、run