AI导哈

Gmail邮件管理服务

一个基于MCP协议的Gmail API封装服务，提供邮件读取、草稿创建和发送功能，适用于远程代理管理场景。

  • by jeff-atriumn
  • 本地部署
  • 更新于
在 GitHub 查看 jeff-atriumn/annex-gmail-mcp

使用说明

附件gmailmcp

用于RAM编排层的Gmail MCP服务器。通过模型上下文协议提供电子邮件读取、起草和发送功能。

概述

此MCP服务器包含Gmail API功能，供 RAM（远程代理管理器）它遵循架构原则：

  • 独立MCP服务器 -RAM配置并调用此服务器
  • 外部数据保持在外部 -无电子邮件存储；按需取货
  • 信任模型执行 -发送操作需要明确批准

建筑

+------------------+     +-------------------+     +---------+
|       RAM        | --> | annex-gmail-mcp   | --> | Gmail   |
| (orchestration)  |     | (MCP server)      |     | API     |
+------------------+     +-------------------+     +---------+

RAM拥有：

  • MCP服务器配置(.mcp.json)
  • 何时呼叫MCP服务器
  • 信任模型执行（发送批准）
  • 生活中的草稿存储(drafts/email/)

此服务器提供：

  • 通过MCP工具抽象Gmail API
  • OAuth2身份验证流程
  • 读取、搜索、起草、发送功能

MCP工具

工具 说明 需要批准
gmail_list_messages 列出最近的电子邮件 否
gmail_search 按查询搜索电子邮件 否
gmail_get_message 获取完整的电子邮件内容 否
gmail_create_draft 在Gmail中创建草稿 否
gmail_send 发送电子邮件 是 （RAM强制执行）
gmail_list_labels 列出Gmail标签 否

设置

看 docs/setup.md 有关详细的设置说明：

  1. 创建GCP项目并启用Gmail API
  2. 配置OAuth同意屏幕
  3. 创建OAuth凭据
  4. 安装并配置MCP服务器
  5. 添加到RAM .mcp.json

RAM集成

添加到RAM .mcp.json:

{
  "mcpServers": {
    "gmail": {
      "command": "node",
      "args": ["/path/to/annex-gmail-mcp/dist/index.js"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "~/.config/ram/google-credentials.json",
        "GOOGLE_TOKEN_PATH": "~/.config/ram/google-token.json"
      }
    }
  }
}

信任模型

RAM执行信任模型，而不是此MCP服务器：

行动 MCP工具 RAM行为
阅读电子邮件 gmail_list_messages, gmail_get_message 直拨电话
搜索电子邮件 gmail_search 直拨电话
创建草稿 gmail_create_draft 直拨电话
发送电子邮件 gmail_send 需要用户批准

审批流程：

  1. 克劳德起草电子邮件至 life-os/drafts/email/
  2. RAM向用户展示草稿
  3. 用户明确批准（“发送”、“批准”）
  4. RAM调用 gmail_send

相关

相关 MCP