一、Gmail MCP服务器概述
Gmail MCP服务器是Model Context Protocol（MCP）生态系统中的一个重要服务端工具，它将Google Gmail邮箱的完整功能通过标准化的MCP接口暴露给AI助手。通过这个服务器，AI可以直接管理和操作Gmail邮箱，实现邮件收发、收件箱管理、邮件分类、标签管理等一系列邮件工作流。
Gmail MCP服务器的核心价值在于：它让AI助手不再是只能"读取"邮件的被动工具，而是能够主动管理和处理邮件的智能助理。用户可以通过自然语言指令让AI完成各种邮件操作，极大地提升了邮件处理效率。无论是个人日常邮件管理，还是企业级的邮件自动化工作流，Gmail MCP服务器都能提供强大的支持。
邮件收发管理
发送邮件、创建草稿、管理收件箱，支持纯文本和HTML格式
智能分类过滤
标签创建和管理，邮件自动分类，收件箱智能整理
高级搜索检索
支持Gmail搜索语法的多维邮件搜索和快速定位
附件数据处理
附件下载、邮件数据分析、信息提取和处理
二、安装与配置
2.1 环境要求
使用Gmail MCP服务器需要以下环境准备：
- Node.js（推荐v18或更高版本）
- 一个有效的Google账号（Gmail地址）
- Google Cloud Platform项目（需启用Gmail API）
- OAuth 2.0凭据（用于API认证授权）
2.2 安装Gmail MCP服务器
通过npm全局安装Gmail MCP服务器包：
npm install -y @anthropic/gmail-mcp-server
或者使用npx直接运行，无需全局安装：
npx @anthropic/gmail-mcp-server
2.3 Google Cloud OAuth 2.0配置
使用Gmail API需要配置OAuth 2.0认证，具体步骤如下：
- 登录 Google Cloud Console
- 创建新项目或选择已有项目
- 导航到"API和服务" → "库"，搜索并启用"Gmail API"
- 转到"API和服务" → "凭据"，创建OAuth 2.0客户端ID
- 应用类型选择"桌面应用"
- 下载JSON格式的客户端凭据文件
- 将下载的凭据文件重命名为
credentials.json 并放置在项目目录中
重要提示： 请妥善保管credentials.json文件，不要将其提交到版本控制系统（如Git）中。该文件包含了你的OAuth客户端ID和密钥，泄露后可能导致他人未经授权访问你的Gmail API配额。
2.4 授权流程
首次运行Gmail MCP服务器时，会自动启动OAuth授权流程：
- 系统会自动在默认浏览器中打开Google授权页面
- 登录你的Google账号并同意所需的权限范围
- 授权成功后，系统会在本地生成
token.json 文件存储访问令牌
- 后续运行将自动使用已保存的令牌，无需重复授权
提示： 访问令牌有过期时间，但Gmail MCP服务器会自动处理令牌刷新，无需手动干预。如果遇到授权问题，可以删除本地的 token.json 文件后重新授权。
2.5 在Claude Code中配置
在Claude Code的配置文件中添加Gmail MCP服务器配置：
{
"mcpServers": {
"gmail": {
"command": "npx",
"args": ["@anthropic/gmail-mcp-server"]
}
}
}
Gmail MCP服务器通过标准化的MCP协议将Gmail API的强大功能无缝集成到AI助手中，使得邮件管理变得像对话一样自然。
点击复制
三、邮件阅读和管理
Gmail MCP服务器提供了丰富的邮件读取和管理功能，可以高效地处理收件箱中的邮件。以下是核心的邮件读取和管理接口：
3.1 列出收件箱邮件 (list_messages)
list_messages 是获取收件箱邮件列表的核心方法，支持多种过滤条件来精确筛选需要的邮件：
- 标签过滤： 按Gmail标签（如INBOX、SENT、IMPORTANT等）筛选邮件
- 搜索词过滤： 使用关键词搜索邮件主题和正文
- 日期范围过滤： 按邮件接收时间或发送时间范围筛选
- 分页控制： 控制返回邮件的数量和偏移量
// 列出收件箱中最近10封未读邮件
list_messages({
labelIds: ["INBOX"],
maxResults: 10,
q: "is:unread"
})
3.2 获取邮件完整内容 (get_message)
get_message 用于获取单封邮件的详细内容，包含：
- 邮件主题： 邮件的标题信息
- 邮件正文： 纯文本或HTML格式的邮件内容
- 发件人信息： 发件人名称和邮箱地址
- 收件人信息： 主要收件人、抄送（CC）和密送（BCC）列表
- 时间戳： 邮件的发送时间和接收时间
- 附件信息： 附件列表，包括附件ID、文件名和MIME类型
3.3 获取邮件附件 (get_attachments)
get_attachments 用于下载邮件中的附件数据。它可以获取指定邮件的附件内容，支持各种MIME类型的附件文件。下载后的附件数据可以进一步用于AI分析、信息提取或文件保存等后续处理。
3.4 删除邮件 (trash_message / delete_message)
Gmail MCP服务器提供两种删除相关操作：
- trash_message： 将邮件移动到垃圾箱，可恢复操作
- delete_message： 永久删除邮件，不可恢复
注意： delete_message是永久性操作，删除后无法恢复。建议在删除重要邮件前先使用trash_message进行软删除，确认无误后再进行永久删除。
四、邮件发送
Gmail MCP服务器提供了完整的邮件发送流程支持，从创建草稿到最终发送，覆盖了邮件撰写的全生命周期：
4.1 发送邮件 (send_mail)
send_mail 是直接发送邮件的功能，支持丰富的邮件格式和收件人配置：
- 多收件人： 支持同时发送给多个收件人
- 抄送（CC）： 添加抄送收件人
- 密送（BCC）： 添加密送收件人，对其他收件人不可见
- 邮件格式： 支持纯文本和HTML格式的邮件正文
- 附件添加： 支持在发送时附带文件
// 发送邮件示例
send_mail({
to: ["zhangsan@example.com", "lisi@example.com"],
cc: ["manager@example.com"],
subject: "项目进度报告",
body: "大家好，\n\n这是本周的项目进度报告，请查收。\n\n谢谢！",
isHtml: false
})
4.2 草稿管理
草稿功能支持邮件的分段撰写和预先准备：
- create_draft： 创建新的邮件草稿，保存未完成的邮件
- update_draft： 更新已有草稿的内容和收件人信息
- send_draft： 将保存的草稿发送出去
草稿管理机制非常适合需要反复修改的邮件场景，或者需要AI分步骤生成和审核邮件内容的场景。可以先创建草稿，让AI检查内容无误后再发送。
提示：可以在创建草稿后，通过update_draft反复修改内容，确认无误后再使用send_draft发送。这种方式提供了邮件发送前的审核环节，特别适合商务邮件等需要谨慎处理的场景。
点击复制
五、标签管理
Gmail的标签系统是邮件分类和组织的核心机制。Gmail MCP服务器提供了完整的标签管理功能：
5.1 列出所有标签 (list_labels)
list_labels 用于获取当前Gmail账号中的所有标签列表，包括系统预定义的标签（如INBOX、SENT、STARRED等）和用户自定义标签。返回的信息包括标签名称、ID、类型和显示设置等。
5.2 创建标签 (create_label)
create_label 允许用户创建自定义标签，用于邮件分类管理。可以指定标签的名称、颜色、可见性等属性。
// 创建新标签
create_label({
name: "项目A/2025",
labelListVisibility: "labelShow",
messageListVisibility: "show"
})
5.3 为邮件添加/移除标签 (modify_message_labels)
modify_message_labels 是标签管理的核心操作，可以对指定邮件进行：
- 添加标签： 为一封或多封邮件添加指定标签
- 移除标签： 从邮件中移除指定标签
- 批量操作： 同时处理多封邮件的标签变更
最佳实践： 建议建立层次化的标签体系，如"项目/项目名称/年份"的标签结构。配合自动过滤规则，可以实现邮件的全自动分类管理，大幅提升收件箱整理效率。
六、搜索功能
Gmail MCP服务器集成了强大的邮件搜索功能，支持使用Gmail搜索语法进行多维度的精准搜索：
6.1 高级搜索 (search_messages)
search_messages 提供比list_messages更灵活的搜索能力，支持以下搜索维度：
- 发件人搜索： 使用
from: 语法按发件人邮箱或姓名搜索
- 主题搜索： 使用
subject: 语法按邮件主题搜索
- 关键词搜索： 在邮件正文中搜索特定关键词
- 日期范围： 使用
after: 和 before: 按时间范围搜索
- 附件过滤： 使用
has:attachment 筛选含有附件的邮件
- 标签筛选： 使用
in: 或 label: 按标签筛选
- 阅读状态： 使用
is:read 或 is:unread 筛选
// 搜索示例：上个月来自客户的含附件邮件
search_messages({
q: "from:client@example.com after:2025/4/1 before:2025/5/1 has:attachment"
})
6.2 组合搜索技巧
Gmail搜索语法支持逻辑运算符组合多个条件：
- AND（默认）： 多个条件用空格分隔，表示同时满足
- OR： 使用
OR 关键字表示满足任一条件
- NOT（-）： 使用减号前缀排除特定条件的邮件
- 括号分组： 使用括号对复杂条件进行分组
Gmail搜索语法功能非常强大，熟练掌握后可以精准定位到任意一封邮件。配合AI的语义理解能力，用户只需要用自然语言描述需求，AI就能自动构建合适的搜索查询。
点击复制
七、实际应用场景
7.1 邮件智能分类和标签自动整理
利用Gmail MCP服务器的标签管理功能，可以实现邮件的智能分类和自动整理：
- 根据发件人自动归档：将特定发件人的邮件自动归类到对应的项目标签下
- 按主题自动分类：根据邮件主题关键词自动分配标签
- 定期整理收件箱：批量处理已读邮件，将旧邮件归档到对应标签
- 建立自动化工作流：结合AI分析邮件内容，自动决定邮件分类和处理优先级
7.2 根据邮件内容自动生成待办事项
AI可以自动阅读邮件内容，提取任务信息并生成待办事项：
- 识别邮件中的任务指派、截止日期和优先级信息
- 将重要的待办事项提取汇总，生成任务清单
- 自动标记需要回复的邮件，跟踪回复状态
- 对紧急邮件进行标记和提醒
7.3 邮件模板快速发送和回复
对于需要频繁发送的相似内容的邮件，可以利用AI和草稿功能实现高效处理：
- 创建常用邮件模板库，通过AI调用快速生成个性化邮件
- 智能回复：AI根据收到的邮件内容自动生成回复草稿
- 批量发送：结合模板和变量替换，快速批量发送个性化邮件
- 多语言翻译：AI可以将邮件翻译成目标语言后再发送
7.4 邮件数据的检索和分析
结合Gmail的搜索功能和AI的数据分析能力：
- 根据关键词、时间范围等条件检索历史邮件
- 从大量邮件中提取结构化数据（如报价、合同信息、联系人等）
- 分析邮件沟通模式，生成沟通报告
- 导出特定类型的邮件数据用于后续处理
总结： Gmail MCP服务器将Gmail的强大功能与AI的智能处理能力完美结合，是提升邮件处理效率的利器。从个人日常邮件管理到企业级邮件自动化工作流，Gmail MCP服务器都能发挥重要作用。掌握它的使用方法，将让邮件管理工作变得前所未有的高效和便捷。