Gmail MCP Server

社区

Gmail API 的模型上下文协议服务器实现

分类: 云存储第 7 / 15
Stars: ★ 62 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 10 个月前 ⚠
工具数: 65

58FMRS · C

Gmail MCP Server 是一个功能全面的 Gmail API 集成，提供了广泛的邮件和设置管理能力。它支持多种安装方式，包括 npx 和远程 Smithery，并且配置灵活。然而，它需要 OAuth 设置，存在一定的安全风险，且默认收集遥测数据。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

12/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 证据显示仓库结构清晰，包含完整工具列表，但未提供测试或CI配置。由于静态审查不可执行，且缺乏自动化测试证据，评分限制在12分以下。扣分主要原因是没有测试和CI，未能证实关键路径的可复现性。
安全与权限 12/20: OAuth2流程使用用户提供的客户端ID和密钥，令牌存储于本地文件，没有发现硬编码秘密。但未看到明确的权限最小化说明或危险操作的确认机制（如删除操作默认需确认）。存在远程安装示例，但未涉及真实令牌。扣分点包括没有明确的数据边界声明和极简权限说明。
维护活跃度 12/20: 仓库活跃，有22次提交历史和较新的更新，但没有看到明确的版本发布计划、依赖更新策略或安全响应渠道。license为MIT。扣分原因是没有版本标签和依赖管理策略，且问题响应情况未知。
文档质量 14/20: README详尽，包括功能、安装、配置变量和完整工具列表，但缺少故障排除、限制和成本说明。存在数据收集和隐私政策，但未提供审计证据。扣分点是文档未覆盖所有潜在错误和限制。
安装易用性 12/20: 文档提供了多种安装方式（Smithery, npx, 从源码构建），并给出配置示例。但OAuth设置步骤较复杂，且依赖外部服务。无CI或测试证据，扣分原因是安装流程手动且没有验证。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要与 Gmail 账户集成的 AI 应用开发者和企业
希望通过自然语言控制邮件流程的用户
希望利用 Gmail 强大功能的 MCP 客户端用户

不适合谁

没有 Google Workspace 或 Gmail 账户的用户
需要实时同步或推送通知但不想配置 watch 的用户
对隐私敏感，不希望发送遥测数据的用户（可禁用遥测）

所需权限

需要访问用户的 Gmail 账户，进行读取、发送、删除邮件、管理标签、设置等操作
需要 OAuth 2.0 授权，获取访问令牌和刷新令牌

风险与副作用

邮件数据泄露风险：服务器可能读取和处理邮件内容
意外删除或修改邮件：发送、删除等操作不可逆
遥测数据收集：默认启用遥测，可能包含匿名使用数据但不含个人身份信息

安装接入

准备工作

运行环境：Node.js 18+ · 远程托管（无需本地环境）

CLIENT_ID 可选密钥 Google API 客户端 ID，来自 GMAIL_OAUTH_PATH 文件，远程部署时必填

CLIENT_SECRET 可选密钥 Google API 客户端密钥，远程部署时必填，属敏感信息

REFRESH_TOKEN 可选密钥用户 OAuth 刷新令牌，远程部署时必填，属敏感信息

其他可选配置项（6 个）

AUTH_SERVER_PORT 可选本地 OAuth 临时认证服务端口，默认 3000

GMAIL_CREDENTIALS_PATH 可选用户凭证文件路径，默认 MCP_CONFIG_DIR/credentials.

GMAIL_OAUTH_PATH 可选 Google API 客户端密钥文件路径，默认 MCP_CONFIG_DIR/gcp-oauth.keys.

MCP_CONFIG_DIR 可选配置文件存放目录，默认 ~/.gmail-mcp

PORT 可选 Streamable HTTP 传输方式使用的端口，默认 3000

TELEMETRY_ENABLED 可选是否启用匿名遥测，默认 true

确保已安装 Node.js 18+。
在 Google Cloud Console 中创建 OAuth 2.0 客户端 ID（桌面应用），并保存密钥文件到 ~/.gmail-mcp/gcp-oauth.keys.json。
运行 npx @shinzolabs/gmail-mcp auth 完成 OAuth 授权。
在 MCP 客户端配置中添加服务器，例如使用 npx 命令。

claude_desktop_config.json

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@shinzolabs/gmail-mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@shinzolabs/gmail-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add gmail -- npx @shinzolabs/gmail-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应能看到 get_profile、list_messages、send_message 等工具；调用 get_profile 若能返回当前 Gmail 用户资料，说明 OAuth 认证与连接正常。

常见排障

OAuth 问题：确保 gcp-oauth.keys.json 文件路径正确，重新运行 auth 命令
远程服务器连接问题：检查 CLIENT_ID、CLIENT_SECRET、REFRESH_TOKEN 是否设置正确
端口冲突：如果使用自定义 AUTH_SERVER_PORT，确保端口未被占用
API 权限不足：确保在 Google Cloud Console 中正确启用 Gmail API

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我列出收件箱里最近的 10 封邮件
用我的 Gmail 账号给同事发一封邮件
把主题包含'账单'的邮件移到回收站
为我的邮箱创建一个名为'工作'的新标签

工具能力 65

get_profile 只读

获取当前用户的 Gmail 个人资料

stop_mail_watch 写入

停止接收推送通知

watch_mailbox 写入

设置邮箱变更的推送通知

list_messages 只读

列出邮件，可带有过滤条件

get_message 只读

获取特定邮件

get_attachment 只读

获取邮件附件

modify_message 写入

修改邮件标签

send_message 破坏性

向指定收件人发送邮件

展开其余 57 个工具

delete_message 破坏性

永久删除邮件

trash_message 破坏性

将邮件移至回收站

untrash_message 写入

从回收站恢复邮件

batch_modify_messages 写入

批量修改邮件

batch_delete_messages 破坏性

批量删除邮件

list_labels 只读

列出所有标签

get_label 只读

获取特定标签

create_label 写入

创建新标签

update_label 写入

更新标签

patch_label 写入

部分更新标签

delete_label 破坏性

删除标签

list_threads 只读

列出邮件线程

get_thread 只读

获取特定线程

modify_thread 写入

修改线程标签

trash_thread 破坏性

将线程移至回收站

untrash_thread 写入

从回收站恢复线程

delete_thread 破坏性

删除线程

list_drafts 只读

列出草稿

get_draft 只读

按 ID 获取草稿

create_draft 写入

创建草稿邮件

update_draft 写入

替换草稿内容

delete_draft 破坏性

删除草稿

send_draft 破坏性

发送现有草稿

get_auto_forwarding 只读

获取自动转发设置

update_auto_forwarding 写入

更新自动转发设置

get_imap 只读

获取 IMAP 设置

update_imap 写入

更新 IMAP 设置

get_pop 只读

获取 POP 设置

update_pop 写入

更新 POP 设置

get_vacation 只读

获取休假回复设置

update_vacation 写入

更新休假回复

get_language 只读

获取语言设置

update_language 写入

更新语言设置

list_delegates 只读

列出账户委托

get_delegate 只读

获取特定委托

add_delegate 写入

添加委托

remove_delegate 写入

移除委托

list_filters 只读

列出邮件过滤器

get_filter 只读

获取特定过滤器

create_filter 写入

创建新过滤器

delete_filter 破坏性

删除过滤器

list_forwarding_addresses 只读

列出转发地址

get_forwarding_address 只读

获取特定转发地址

create_forwarding_address 写入

创建转发地址

delete_forwarding_address 破坏性

删除转发地址

list_send_as 只读

列出发送别名

get_send_as 只读

获取特定发送别名

create_send_as 写入

创建发送别名

update_send_as 写入

更新发送别名

patch_send_as 写入

部分更新发送别名

verify_send_as 写入

发送验证邮件

delete_send_as 破坏性

删除发送别名

list_smime_info 只读

列出 S/MIME 配置

get_smime_info 只读

获取特定 S/MIME 配置

insert_smime_info 写入

上传新的 S/MIME 配置

set_default_smime_info 写入

设置默认 S/MIME 配置

delete_smime_info 破坏性

删除 S/MIME 配置

使用场景

通过 AI 助手管理 Gmail 邮件，如发送、阅读、搜索邮件

自动化邮件过滤和标签管理

管理邮件线程和草稿

设置自动转发、休假回复等邮箱设置

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

一个基于 Model Context Protocol (MCP) 的 Gmail API 服务器实现，为邮件管理、发送和检索提供标准化接口。支持完整的 Gmail API 覆盖，包括邮件、线程、标签、草稿和设置。

Gmail MCP Server

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

工具能力 65

使用场景

支持客户端

详细介绍

同类可选方案