Gmail MCP

Gmail MCP Server

A. 模型上下文协议（MCP） 服务器实现 Gmail API，为电子邮件管理、发送和检索提供标准化接口。

特性

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

先决条件

依赖项

为了实现最简单的安装，请安装 。如果您想在本地构建，还需要安装 .

谷歌工作区设置

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

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

1. 转到 谷歌云控制台.
2. 创建新项目或选择现有项目。
3. 为您的项目启用Gmail API。
4. 转到凭据并创建OAuth 2.0客户端ID。为客户端类型选择“桌面应用程序”。
5. 下载OAuth密钥JSON并将其另存为 ~/.gmail-mcp/gcp-oauth.keys.json. ⚠️ 注意：创建 ~/.gmail-mcp/ 通过MacOS的Finder应用程序，您需要 启用隐藏文件 第一。
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和 API密钥。对于本地安装，请使用 npx 或者从源代码构建。下文将逐一解释这些选项。

Smithery远程服务器（推荐）

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

npx -y @smithery/cli install @shinzo-labs/gmail-mcp

输入您的 CLIENT_ID, CLIENT_SECRET，以及 REFRESH_TOKEN 当提示时。

Smithery软件开发工具包

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

NPX本地安装

使用以下命令在本地安装服务器 npx，将以下内容添加到您的MCP客户端 config.json:

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

从源代码构建

1. 下载仓库：

git clone https://github.com/shinzo-labs/gmail-mcp.git

1. 安装软件包并使用构建 pnpm （克隆仓库内）：

pnpm i && pnpm build

1. 将以下内容添加到您的MCP客户端 config.json:

{
  "mcpServers": {
    "gmail": {
      "command": "node",
      "args": [
        "/path/to/gmail-mcp/dist/index.js"
      ]
    }
  }
}

配置变量

支持的端点

用户管理

• 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：列表以别名发送
• get_send_as：获取特定的发送别名
• create_send_as：创建发送别名
• update_send_as：更新以别名发送
• patch_send_as：以别名发送的部分更新
• verify_send_as：发送验证电子邮件
• delete_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配置

贡献

欢迎和鼓励捐款！请阅读 贡献.md 有关问题、贡献和联系信息的指导方针。

数据收集和隐私

Shinzo Labs从该服务器收集有限的匿名遥测数据，以帮助改进我们的产品和服务。在此过程中，不会收集任何个人身份信息。请查看 隐私政策 有关收集的数据类型以及如何选择退出此遥测的更多详细信息。

许可证

麻省理工学院