@agentcomms/gmail-mcp

中文文档
0.37.0发布于 2026/10/29MITES Module构建来源已验证近 30 天下载 4782

用于编码代理的Gmail MCP服务器:搜索,读取,分析并起草横跨收件箱,通过批准发送门.

中文使用文档
文档目录6 节
  1. 先设置邮箱
  2. 连接代理服务器的邮箱
  3. 如何批准更改
  4. 选项
  5. 发送
  6. 许可证

@ agentcomms/ gmail- mcp (英语)

用于编码代理的 Gmail MCP 服务器作为自己的命令——所以客户端配置可以将其打入:

{
  "mcpServers": {
    "gmail": { "command": "npx", "args": ["-y", "@agentcomms/[email protected]"] }
  }
}

这是一次召唤 @agentcomms/gmail,这就是服务器的位置 编辑 agent-gmail 命令现场。 部分 代理通讯。 。 。 .

先设置邮箱

此软件包为邮箱服务; 连接它们为 @agentcomms/gmail,而一个命令做这一切—— google Cloud 步骤,客户端,第一个邮箱, 并且向您的代理注册此服务器:

npx @agentcomms/gmail setup

要单独登记,或将现有登记移至新版本:

npx @agentcomms/gmail mcp install --client claude-code --launcher npx

它显示它会注册什么,请您输入 yes; 由代理操作, 它退出 10 预览和一个 批准编号,再运行时登记 --approval <id> 一旦你同意的话.

连接代理服务器的邮箱

一个被请求"设置Gmail"的特工不需要送你去终端: gmail_setup 说什么是缺失,当得到 profile,通过其自身的 orgApproval;否则,它不会改变任何东西. gmail_client_add 从您下载的 JSON 路径中注册 OAuth 客户端, gmail_inbox_add 返回登录链接并停止,以及 gmail_inbox_finish 一旦Google归还赠款就完成。 补助金是 您仍然可以在自己的浏览器中批准 —— 此服务器不打开一个, 并且不能批准它 。 客户JSON是 从机器上的路径读取, 从来没有粘入对话, 没有工具返回它的秘密.

其他的都一样 agent-gmail 对一个账户来说,也是一种工具,每个操作都与其命令相同:

工具命令
gmail_inbox_show, (中文(简体) ), gmail_inboxes_listinbox show, (中文(简体) ), inbox list
gmail_inbox_renameinbox rename
gmail_inbox_policy 发送政策和变更政策inbox policy --send --change
gmail_inbox_reauth,则 gmail_inbox_finishinbox reauth --start,则 --finish
gmail_inbox_importinbox import
gmail_inbox_removeinbox remove
gmail_clients_list, (中文(简体) ), gmail_client_add, (中文(简体) ), gmail_client_removeclient list|add|remove
gmail_confirm_clients, (中文(简体) ), gmail_confirm_client_add, (中文(简体) ), gmail_confirm_client_removeconfirm-clients list|add|remove

要将已有的邮箱移动到组织配置文件的活跃客户端, 请从 comms_org_show,然后调用 gmail_inbox_reauth 与那个 client (终端形式是: agent-gmail inbox reauth <name> --client <organisation>-1 --start并正常地完成它.

如何批准更改

放宽安全环境或不能收回的改变——政策松散、赠款扩大、OAuth客户端增加 或删除、进口或删除的邮箱、可信任显示批准表的客户——第一个邮箱不发生 电话 工具返回 approvalRequired页:1 preview 到底会发生什么变化 approvalId; 代理人 显示预览并询问。 在 chat 更改策略( 默认) 您的“ 是” 是批准 , 而代理 再用身份证打电话 下 confirm 运行结果给出的核准命令, 准确无误的, 在您自己的 终端和键入它首先显示的代码; 代理机学习您拥有的代码 gmail_send_wait并再次打电话. 一个批准是它所预览的改变,一次: 它等待10分钟在聊天中同意,30分钟为你 终端,并保持24小时 一旦你批准在那里。 如果在索赔时有什么不同 拒绝的,变更是准备的;如果拒绝的,由代理人撤销。 收紧需要任何人。 也可以向命令行申请同样的批准 --approval <id>换个角度.

无法从服务器中预留作者 --read-only一个被钉在一个邮箱上 --inbox 提议, 上面的工具, 读取, gmail_inbox_policy 为自己的邮箱,和 gmail_confirm_client_remove, (中文(简体) ), 因为信任更少的客户端不需要任何人; 它不会重命名、 重授权、 导入、 删除、 添加或删除 OAuth 客户端,或添加信任的客户端.

选项

选项效果
--inbox <alias>只服务于邮箱 inbox 参数变为可选
--read-only仅登记无法更改任何工具

发送

这里没有自动发送邮件的工具 。 已准备发送, 向用户全文显示, 并在发送后发送 批准准确的内容——同一个消息,同一个收件人,在一个短窗口内,一次. 每封邮件 允许起草的许可也允许发送,因此规则存在于代码而不是赠款中.

许可证

麻省理工学院

版本与发布记录

@agentcomms/gmail-mcp 共发布 59 个版本,首次发布于 2026/09/20;过去 12 个月发布了 59 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.37.0latest2026/10/299 天前
0.36.02026/10/2810 天前
0.35.02026/10/2811 天前
0.34.02026/10/2711 天前
0.33.02026/10/2712 天前
0.32.02026/10/2612 天前

关于 @agentcomms/gmail-mcp 的常见问题

@agentcomms/gmail-mcp 是什么?

用于编码代理的Gmail MCP服务器:搜索,读取,分析并起草横跨收件箱,通过批准发送门.

如何安装 @agentcomms/gmail-mcp?

在项目目录运行 npm install @agentcomms/gmail-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-gmail-mcp,可以用 npx agent-gmail-mcp 直接运行。

@agentcomms/gmail-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/agentcomms__gmail-mcp 是否存在。

@agentcomms/gmail-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agentcomms/gmail-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@agentcomms/gmail-mcp 可以商用吗?

@agentcomms/gmail-mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agentcomms/gmail-mcp 的下载量有多少?

根据 npm 官方下载统计,@agentcomms/gmail-mcp 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,782 次,日均约 159 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agentcomms/gmail-mcp 还在维护吗?

最新版本 0.37.0 发布于 2026/10/29(9 天前);至今共发布 59 个版本,其中过去 12 个月发布了 59 个;首次发布于 2026/09/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。