🚀 Yet Another Gmail MCP 服务器

Yet Another Gmail MCP 服务器提供了一系列工具，可借助模型上下文协议（MCP）与您的 Gmail 账户进行交互，方便您管理邮件。

🚀 快速开始

Gmail MCP 服务器提供了工具，让您可以通过模型上下文协议（MCP）与 Gmail 账户进行交互。下面为您详细介绍设置与使用方法。

📦 安装指南

先决条件

1. 为 Gmail API 创建 OAuth 凭证：
   • 前往 Google Cloud Console
   • 创建新项目或选择现有项目
   • 启用 Gmail API
   • 创建 OAuth 2.0 凭证（桌面应用）
   • 下载凭证 JSON 文件并保存为 ~/.yagms-oauth.keys.json

构建此项目

1. 安装 Bun。
2. 构建代码

bun install
bun run build-gmail # 会在 ./dist/gmail.js 发射

💻 使用示例

身份验证

在使用 Gmail MCP 服务器之前，需要先进行身份验证：

# 运行身份验证流程
bun run dist/gmail.js auth

这将：

• 打开浏览器窗口供您登录 Google 账户
• 请求访问您的 Gmail 账户的权限
• 将认证凭证保存到 ~/.yagms-credentials.json

运行服务器

身份验证完成后，可以运行 Gmail MCP 服务器：

# 启动服务器
bun run src/gmail.ts

配置

可以通过环境变量自定义 OAuth 凭证和凭证的路径：

• GMAIL_OAUTH_PATH：OAuth 凭证文件路径（默认：~/.yagms-oauth.keys.json）
• GMAIL_CREDENTIALS_PATH：保存凭证的路径（默认：~/.yagms-credentials.json）

可用工具

Gmail MCP 服务器提供以下工具：

1. list - emails：获取您收件箱中的电子邮件

• 参数：
  • senderEmail（可选）：按发件人邮箱过滤
  • maxResults（可选，默认：10）：要返回的最大邮件数
  • labelIds（可选， 默认：["INBOX"]）：按标签 ID 过滤

2. get - email：通过 ID 获取特定电子邮件

• 参数：
  • emailId：要检索的电子邮件 ID

3. search - emails：使用 Gmail 搜索语法搜索电子邮件

• 参数：
  • query：Gmail 搜索查询（例如："from:example@gmail.com has:attachment"）
  • maxResults（可选， 默认：10）：要返回的最大邮件数

4. get - labels：获取所有 Gmail 标签

• 无需参数

示例 MCP 配置

将此内容添加到您的 MCP 设置文件中：

{
  "mcpServers": {
    "gmail": {
      "command": "bun",
      "args": ["run", "/path/to/yagms/dist/gmail.js"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}