AI导哈

Gmail MCP服务器

一个提供Gmail访问的模型上下文协议(MCP)服务器，支持Claude Code和其他兼容MCP的客户端进行邮件管理。

  • by brentwpeterson
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 brentwpeterson/mcp-gmail

使用说明

Gmail MCP服务器

一种模型上下文协议（MCP）服务器，为Claude Code和其他兼容MCP的客户端提供Gmail访问。

特性

  • 列出来自任何文件夹（收件箱、已发送、未读、带星号等）的电子邮件
  • 阅读完整的电子邮件内容
  • 发送带有自动签名的电子邮件
  • 使用合适的螺纹头回复螺纹
  • 使用Gmail的查询语法进行搜索
  • 管理标签（星号、存档、标记已读/未读）

先决条件

  • Node.js 20或更高版本
  • 启用Gmail API的谷歌云项目
  • OAuth 2.0凭据（桌面应用程序类型）

设置

1.创建谷歌云项目

如果你还没有：

gcloud projects create your-project-name --name="Your MCP Tools"
gcloud config set project your-project-name
gcloud services enable gmail.googleapis.com

2.配置OAuth同意屏幕

  1. 首选 谷歌云控制台-OAuth同意
  2. 选择 内部 （适用于谷歌工作区）或 外部的 （适用于个人Gmail）
  3. 添加以下范围：
    • https://www.googleapis.com/auth/gmail.readonly
    • https://www.googleapis.com/auth/gmail.send
    • https://www.googleapis.com/auth/gmail.modify

3.创建OAuth凭据

  1. 首选 谷歌云控制台-凭据
  2. 点击 创建凭据 > OAuth客户端ID
  3. 选择 桌面应用 作为应用程序类型
  4. 下载JSON文件
  5. 另存为 ~/.mcp-gmail/credentials.json

4.安装和构建

git clone https://github.com/brentwpeterson/mcp-gmail.git
cd mcp-gmail
npm install
npm run build

5.身份验证

npm run auth

这将打开Google OAuth浏览器。批准权限，令牌将保存到 ~/.mcp-gmail/token.json.

6.配置您的MCP客户端

添加到您的MCP配置文件中（例如。， .mcp.json 克劳德代码）：

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

重新启动MCP客户端以加载服务器。

可用工具

工具 说明
gmail_list_emails 使用可选文件夹和搜索查询列出最近的电子邮件
gmail_get_email 获取特定电子邮件的完整内容
gmail_send_email 发送新电子邮件或回复帖子
gmail_search 使用Gmail查询语法搜索电子邮件
gmail_get_thread 获取对话中的所有消息
gmail_modify_labels 添加/删除标签（读取、星号、存档）
gmail_list_labels 列出所有可用标签

文件夹选项

这 gmail_list_emails 该工具支持以下文件夹：

文件夹 描述
inbox （默认） 收件箱电子邮件
sent 已发送电子邮件
unread 未读收件箱电子邮件
starred 带星号的电子邮件
important 重要电子邮件
trash 已删除的电子邮件
spam 垃圾邮件文件夹
all 所有电子邮件（无过滤器）

Gmail搜索语法

这 gmail_search 工具和 query 参数支持Gmail的搜索语法：

  • from:user@example.com -来自特定发件人
  • to:user@example.com -致特定收件人
  • subject:meeting -主题包含单词
  • is:unread -未读邮件
  • is:starred -带星号的消息
  • has:attachment -有附件
  • newer_than:2d -超过2天
  • older_than:1w -超过1周
  • label:work -具有特定标签

与空格（AND）或 OR: from:boss@work.com is:unread

配置

环境变量（可选）：

变量 描述 默认值
GMAIL_CONFIG_DIR 配置目录 ~/.mcp-gmail
GMAIL_CREDENTIALS_PATH credentials.json的路径 ~/.mcp-gmail/credentials.json

运作原理

  • 签名：自动从您的Gmail“以其他方式发送邮件”设置中提取
  • 主题回复：适当 In-Reply-To 和 References 正确穿线的接头
  • 发件人姓名：使用Gmail设置中的显示名称

安全

  • OAuth令牌存储在本地 ~/.mcp-gmail/token.json
  • 凭据和令牌永远不会被提交（请参阅 .gitignore)
  • 只有您可以通过此服务器访问您的电子邮件
  • 代币可以随时撤销 Google帐户权限

许可证

麻省理工学院

相关 MCP