# @agentcomms/gmail-mcp 中文文档

规范地址：https://npmcn.com/package/%40agentcomms/gmail-mcp/

版本：0\.37\.0
npm 元数据更新时间：2026-10-28T22:09:58.344Z
中文译文更新时间：2026-11-06T05:24:50.525Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentcomms/gmail-mcp
原文对照：https://npmcn.com/package/%40agentcomms/gmail-mcp/?lang=original
源码仓库：https://github.com/crissmoldovan/agent-communications

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：11 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.12\.0
- 运行依赖：1 个
- 首次发布：2026-09-19T20:07:16.911Z
- 最新版本发布：2026-10-28T22:09:57.946Z
- 近 30 天下载量：4782（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：59（近 12 个月 59 个）

## 中文简介

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

## 安装

```sh
npm install @agentcomms/gmail-mcp
```

也可以使用：`pnpm add @agentcomms/gmail-mcp`、`yarn add @agentcomms/gmail-mcp`、`bun add @agentcomms/gmail-mcp`

## README

# @ agentcomms/ gmail- mcp (英语)

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

```json
{
  "mcpServers": {
    "gmail": { "command": "npx", "args": ["-y", "@agentcomms/gmail-mcp@0.1.0"] }
  }
}
```

这是一次召唤 [`@agentcomms/gmail`](https://www.npmjs.com/package/@agentcomms/gmail),这就是服务器的位置 编辑 `agent-gmail` 命令现场。 部分 [代理通讯](https://github.com/crissmoldovan/agent-communications)。 。 。 .

## 先设置邮箱

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

```sh
npx @agentcomms/gmail setup
```

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

```sh
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_list` | `inbox show`, (中文(简体) ), `inbox list` |
| `gmail_inbox_rename` | `inbox rename` |
| `gmail_inbox_policy` 发送政策和变更政策 | `inbox policy --send --change` |
| `gmail_inbox_reauth`,则 `gmail_inbox_finish` | `inbox reauth --start`,则 `--finish` |
| `gmail_inbox_import` | `inbox import` |
| `gmail_inbox_remove` | `inbox remove` |
| `gmail_clients_list`, (中文(简体) ), `gmail_client_add`, (中文(简体) ), `gmail_client_remove` | `client list|add|remove` |
| `gmail_confirm_clients`, (中文(简体) ), `gmail_confirm_client_add`, (中文(简体) ), `gmail_confirm_client_remove` | `confirm-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 是什么？

用于编码代理的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 和提交记录判断。