适合谁
- 需要与 Gmail 账户集成的 AI 应用开发者和企业
- 希望通过自然语言控制邮件流程的用户
- 希望利用 Gmail 强大功能的 MCP 客户端用户
G
58FMRS · C
Gmail MCP Server 是一个功能全面的 Gmail API 集成，提供了广泛的邮件和设置管理能力。它支持多种安装方式，包括 npx 和远程 Smithery，并且配置灵活。然而，它需要 OAuth 设置，存在一定的安全风险，且默认收集遥测数据。
一个基于 Model Context Protocol (MCP) 的 Gmail API 服务器实现，为邮件管理、发送和检索提供标准化接口。支持完整的 Gmail API 覆盖，包括邮件、线程、标签、草稿和设置。
工具能力
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
创建草稿邮件
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 配置
安装接入
- 确保已安装 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"
]
}
}
}
选型与风险
不适合谁
- 没有 Google Workspace 或 Gmail 账户的用户
- 需要实时同步或推送通知但不想配置 watch 的用户
- 对隐私敏感，不希望发送遥测数据的用户（可禁用遥测）
所需权限
- 需要访问用户的 Gmail 账户，进行读取、发送、删除邮件、管理标签、设置等操作
- 需要 OAuth 2.0 授权，获取访问令牌和刷新令牌
风险与副作用
- 邮件数据泄露风险：服务器可能读取和处理邮件内容
- 意外删除或修改邮件：发送、删除等操作不可逆
- 遥测数据收集：默认启用遥测，可能包含匿名使用数据但不含个人身份信息
常见排障
- OAuth 问题：确保 gcp-oauth.keys.json 文件路径正确，重新运行 auth 命令
- 远程服务器连接问题：检查 CLIENT_ID、CLIENT_SECRET、REFRESH_TOKEN 是否设置正确
- 端口冲突：如果使用自定义 AUTH_SERVER_PORT，确保端口未被占用
- API 权限不足：确保在 Google Cloud Console 中正确启用 Gmail API
使用场景
通过 AI 助手管理 Gmail 邮件，如发送、阅读、搜索邮件
自动化邮件过滤和标签管理
管理邮件线程和草稿
设置自动转发、休假回复等邮箱设置
支持客户端
Claude Desktop完整支持