Gmail MCP

Gmail 多账户管理平台

Gmail API 的模型上下文协议 (MCP)实现，为电子邮件管理、发送和检索提供标准化接口。

特征

• 完整的 Gmail API 覆盖范围，包括消息、线程、标签、草稿和设置
• 支持发送、起草和管理电子邮件
• 具有可自定义颜色和可见性设置的标签管理
• 对话管理的线程操作
• 设置管理，包括休假回复、IMAP/POP 和语言设置
• 邮箱更改的历史记录跟踪
• 使用 Google Cloud 凭据进行安全 OAuth2 身份验证

先决条件

要运行此 MCP 服务器，您首先需要为您的组织设置一个 Google API 客户端，每个用户运行一个脚本来检索他们自己的 OAuth 刷新令牌。

Google API 客户端设置（每个组织一次）

1. 转到Google Cloud Console 。
2. 创建新项目或选择现有项目。
3. 为您的项目启用 Gmail API。
4. 前往“凭据”并创建 OAuth 2.0 客户端 ID。客户端类型选择“桌面应用”。
5. 下载 OAuth 密钥 JSON 并将其保存为~/.gmail-mcp/gcp-oauth.keys.json 。
6. （可选）对于远程服务器安装（例如使用 Smithery CLI），请记下此文件中的CLIENT_ID和CLIENT_SECRET 。

客户端 OAuth（每个用户一次）

1. 让用户将~/.gmail-mcp/gcp-oauth.keys.json复制到他们计算机上的同一路径。
2. 运行npx @shinzolabs/gmail-mcp auth 。
3. 将打开一个浏览器窗口，用户可以在其中选择配置文件、查看请求的范围并进行批准。
4. （可选）对于远程服务器安装，请记下成功消息中提到的文件路径（默认为~/.gmail-mcp/credentials.json ）。用户的REFRESH_TOKEN可在此处找到。

客户端配置

您可以通过多种方式配置 MCP 客户端和服务器。对于托管/远程服务器设置，请使用 Smithery 的 CLI 和Smithery API 密钥。对于本地安装，请使用npx或从源代码构建。以下将逐一解释这些选项。

Smithery 远程服务器（推荐）

要将远程服务器添加到 MCP 客户端config.json ，请从Smithery CLI运行以下命令：

出现提示时，输入您的CLIENT_ID 、 CLIENT_SECRET和REFRESH_TOKEN 。

Smithery SDK

如果您正在开发自己的代理应用程序，则可以使用此处的样板代码。

NPX 本地安装

要使用npx在本地安装服务器，请将以下内容添加到 MCP 客户端config.json中：

从源代码构建

1. 下载 repo：

2. 安装软件包并使用pnpm构建（在克隆的 repo 内）：

3. 将以下内容添加到您的 MCP 客户端config.json中：

配置变量

支持的端点

用户管理

• get_profile ：获取当前用户的 Gmail 个人资料
• stop_mail_watch ：停止接收推送通知
• watch_mailbox ：设置邮箱更改的推送通知

消息管理

管理消息

• list_messages ：列出带有可选过滤的消息
• get_message ：获取特定消息
• get_attachment ：获取消息附件
• modify_message消息标签
• send_message ：向指定收件人发送电子邮件消息
• 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 ：在 Gmail 中创建电子邮件草稿
• update_draft ：替换草稿的内容
• delete_draft ：删除草稿
• send_draft ：发送现有草稿

设置管理

自动转发

• get_auto_forwarding ：获取自动转发设置
• update_auto_forwarding ：更新自动转发设置

IMAP 设置

• get_imap ：获取 IMAP 设置
• update_imap ：更新 IMAP 设置

POP 设置

• 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 ：列出 send-as 别名
• get_send_as ：获取特定的 send-as 别名
• create_send_as ：创建 send-as 别名
• update_send_as ：更新 send-as 别名
• patch_send_as ：部分更新 send-as 别名
• verify_send_as ：发送验证邮件
• delete_send_as ：删除 send-as 别名

S/MIME 设置

• 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 配置

贡献

欢迎并鼓励大家贡献代码！请阅读CONTRIBUTING.md文件，获取问题、贡献指南和联系信息。