Gmail MCP Server 2

MCP办公协作

提供方 trymeuj · 包名 @smithery/cli

办公协作 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个标准化的Gmail API接口实现,提供邮件管理、发送和检索功能,适用于需要自动化处理Gmail邮件的开发场景。

一句话选型结论

按资料字段整理

Gmail MCP Server 2 属于办公协作类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 68 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量68暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

邮件管理JavaScript本地部署GmailAPI自动化处理OAuth2认证标签管理

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx -y @smithery/cli install @shinzo-labs/gmail-mcp --client claude

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 68 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 68 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Gmail MCP Server 2当前 68 stdio · 本地进程 本地部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方trymeuj上游标注的维护方 trymeuj
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@smithery/cli · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.9 KB
来自项目仓库与上游目录的原文,未做删改

Gmail MCP

⚠️ WARNING: This server is experimental and functionality is not guaranteed. Please use at your own risk.

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

特性

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

安装

要使用此MCP,您需要使用Gmail设置身份验证:

  1. 转到 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 为您的项目启用Gmail API
  4. 转到凭据并创建OAuth 2.0客户端ID
    - 选择“桌面应用程序”作为应用程序类型(警告:如果不选择此类型,服务器将无法解析JSON文件中的密钥)
    - 下载客户端凭据JSON文件
  5. 将下载的凭据文件保存到 ~/.gmail-mcp/gcp-oauth.keys.json

NPX(推荐)

将以下内容添加到您的 claude_desktop_config.json:```javascript
{
"mcpServers": {
"gmail": {
"command": "npx",
"args": [
"@shinzolabs/gmail-mcp"
]
}
}
}


### 手册下载

1. 下载仓库:```bash
git clone https://github.com/shinzo-labs/gmail-mcp.git
  1. 安装软件包并构建(在克隆的仓库中):```bash
    pnpm i && pnpm run build

3. 将以下内容添加到您的 `claude_desktop_config.json`:```javascript
{
"mcpServers": {
"gmail": {
"command": "node",
"args": [
"/path/to/gmail-mcp/dist/index.js"
]
}
}
}

史密瑟里

通过以下方式自动安装Claude Desktop 史密瑟里:```bash
npx -y @smithery/cli install @shinzo-labs/gmail-mcp --client claude


## 身份验证流程

MCP提供自动身份验证流程:

1. 首先,确保您拥有OAuth凭据:

- 放置下载的 `credentials.json` 在……里面 `~/.gmail-mcp/gcp-oauth.keys.json`
- 或设置 `GMAIL_OAUTH_PATH` 指向您的凭据文件

1. 运行身份验证命令:```bash
# If using npx
npx @shinzolabs/gmail-mcp auth

# If in the project directory
pnpm i && pnpm run build && pnpm run auth
  1. 浏览器窗口将自动打开谷歌OAuth同意屏幕
  2. 授予访问权限后,您可以关闭浏览器窗口
  3. 令牌将自动保存到 ~/.gmail-mcp/credentials.json

MCP将自动:

  • 管理令牌刷新
  • 将凭据保存到磁盘
  • 处理OAuth回调
  • 在默认浏览器中打开身份验证URL

您可以使用环境变量自定义凭据文件位置:bash GMAIL_OAUTH_PATH=/custom/path/to/gcp-oauth.keys.json GMAIL_CREDENTIALS_PATH=/custom/path/to/credentials.json

支持的端点

用户管理

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

消息管理

发送和创建消息

  • draft_email:创建电子邮件草稿
  • send_email:发送电子邮件
  • import_message:将邮件导入邮箱
  • insert_message:将邮件插入邮箱

管理邮件

  • list_messages:列出具有可选筛选的邮件
  • get_message:获取特定消息
  • get_attachment:获取邮件附件
  • modify_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:获得一份具体的草稿
  • 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配置

历史

  • list_history:跟踪邮箱的更改

贡献

欢迎并鼓励捐款。联系austin@shinzolabs.com有任何问题、意见或疑虑。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Gmail MCP Server 2 怎么安装?

在客户端按下面的安装命令接入:npx -y @smithery/cli install @shinzo-labs/gmail-mcp --client claude。对应的包名是 @smithery/cli。装完在客户端配置里引用同一个包或端点。

Gmail MCP Server 2 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Gmail MCP Server 2 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Gmail MCP Server 2 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Gmail MCP Server 2 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Gmail MCP Server 2 能提供哪些能力?

资料显示约 68 个工具;能力标签包括 邮件管理、标签管理、JavaScript、Claude、自动化处理。具体工具清单以官方文档为准。

Gmail MCP Server 2 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Gmail MCP Server 2 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。