Email MCP Aa23846d

MCP办公协作

提供方 Flyingon

办公协作 未标注 OAuth 授权 社区 / 第三方

一个基于Go的邮箱管理控制协议服务,支持多账号配置、邮件搜索、发送和接收功能,适用于个人和企业邮件管理。

一句话选型结论

按资料字段整理

Email MCP Aa23846d 属于办公协作类 MCP 服务器,传输方式未标注,OAuth 授权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

邮件管理Go本地部署多账号支持Gmail集成IMAP/SMTP协议OAuth认证

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

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

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

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

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

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Email MCP Aa23846d当前 未标注 未标注 未标注 无 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

服务器档案

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

详细介绍

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

email-mcp

一个基于 Go 的邮箱 MCP 服务,当前第一版优先打通 Gmail,并保留多账号、HTTP 和 stdio 双入口能力。

架构

实现架构说明见:

  • docs/architecture.md
  • docs/implementation-plan.md

当前能力

  • 多账号配置存储
  • Gmail / Outlook / 163 / QQ provider preset
  • IMAP 连接测试
  • SMTP 连接测试
  • 列出邮箱目录
  • 搜索邮件
  • 读取邮件正文
  • 发送支持 To / Cc / Bcc / Reply-To 的邮件
  • MCP stdio 模式
  • MCP Streamable HTTP 模式

启动方式

1. stdio```bash

go run ./cmd/email-mcp serve-stdio


### 2. HTTP```bash
go run ./cmd/email-mcp serve-http --addr :8080 --public-base-url http://localhost:8080

默认端口说明:

  • MCP HTTP 入口:POST /mcp
  • Google OAuth 启动入口:GET /oauth/google/start?account_id=...
  • Google OAuth 回调入口:GET /oauth/google/callback
  • 健康检查:GET /healthz

3. 初始化 Gmail OAuth 账号```bash

go run ./cmd/email-mcp init-gmail-oauth \
--email your-name@gmail.com \
--client-id your-google-client-id \
--client-secret your-google-client-secret


这个命令会把一个 `auth_type=oauth2` 的 Gmail 账号写入账号配置文件。

### 4. 本地调试命令

测试账号连通性:```bash
go run ./cmd/email-mcp test-account --account-id gmail-main

列出邮箱目录:```bash
go run ./cmd/email-mcp list-mailboxes --account-id gmail-main


搜索最近邮件:```bash
go run ./cmd/email-mcp search-messages --account-id gmail-main --mailbox INBOX --limit 20

如果你不想使用默认账号文件路径,可以为任意命令附带:```bash
--accounts-file /path/to/accounts.json


## accounts.json 配置

默认账号配置文件路径:

- `~/.email-mcp/accounts.json`

也可以通过环境变量覆盖:```bash
export EMAIL_MCP_ACCOUNTS_FILE=/path/to/accounts.json

当前程序启动时会做一次兼容迁移:

  • 如果 ~/.email-mcp/accounts.json 不存在
  • 但项目里的旧文件 data/accounts.json 存在
  • 启动时会自动迁移到用户目录

accounts.json 顶层结构

accounts.json 顶层是一个数组,每个元素代表一个邮箱账号。```json
[
{
"...": "一个邮箱账号对象"
}
]


### 通用字段说明

每个账号对象包含这些常见字段:

- `id`
  - 账号唯一标识,MCP 调用时通过它指定账号
- `provider`
  - 例如 `gmail`、`outlook`、`163`、`qq`
- `email_address`
  - 邮箱地址
- `display_name`
  - 发件显示名
- `imap`
  - IMAP 连接配置
- `smtp`
  - SMTP 连接配置
- `auth`
  - 认证配置
- `enabled`
  - 是否启用
- `is_default`
  - 是否默认账号
- `created_at`
- `updated_at`

### App Password 示例

这是 Gmail 最容易先跑通的配置方式:```json
[
  {
    "id": "gmail-main",
    "provider": "gmail",
    "email_address": "your-name@gmail.com",
    "display_name": "Your Name",
    "imap": {
      "host": "imap.gmail.com",
      "port": 993,
      "security": "tls",
      "username": "your-name@gmail.com"
    },
    "smtp": {
      "host": "smtp.gmail.com",
      "port": 465,
      "security": "tls",
      "username": "your-name@gmail.com"
    },
    "auth": {
      "type": "app_password",
      "password": "your-16-char-app-password"
    },
    "enabled": true,
    "is_default": true,
    "created_at": "2026-03-18T00:00:00Z",
    "updated_at": "2026-03-18T00:00:00Z"
  }
]

Google OAuth 示例

如果你要走 Google OAuth,初始配置可以这样:```json
[
{
"id": "gmail-oauth",
"provider": "gmail",
"email_address": "your-name@gmail.com",
"display_name": "Your Name",
"imap": {
"host": "imap.gmail.com",
"port": 993,
"security": "tls",
"username": "your-name@gmail.com"
},
"smtp": {
"host": "smtp.gmail.com",
"port": 465,
"security": "tls",
"username": "your-name@gmail.com"
},
"auth": {
"type": "oauth2",
"oauth2": {
"provider": "google",
"client_id": "your-google-client-id",
"client_secret": "your-google-client-secret",
"scopes": [
"https://mail.google.com/"
]
}
},
"enabled": true,
"is_default": true,
"created_at": "2026-03-18T00:00:00Z",
"updated_at": "2026-03-18T00:00:00Z"
}
]


Google OAuth 授权成功后,程序会自动把这些字段回写进去:

- `auth.oauth2.refresh_token`
- `auth.oauth2.access_token`
- `auth.oauth2.token_expiry`

## Gmail 接入建议

### 方案 A:App Password

建议先准备一个 Gmail App Password,然后用 `email.account.create` 创建账号:```json
{
  "id": "gmail-main",
  "provider": "gmail",
  "email_address": "your-name@gmail.com",
  "display_name": "Your Name",
  "auth_type": "app_password",
  "password": "your-app-password"
}

然后依次调用:

  1. email.account.test_connection
  2. email.mailbox.list
  3. email.message.send

Gmail 认证注意:

  • App Password 的前置条件是开启 2-Step Verification(两步验证)
  • 如何检查是否已开启:
    1. 打开 Google 账号安全页:https://myaccount.google.com/security
    2. 找到 “How you sign in to Google / 登录 Google 的方式” 或 “Signing in to Google / 登录 Google”
    3. 查看 “2-Step Verification / 两步验证” 是否为 “On / 已开启”
  • 如何开启(未开启时):
    1. 进入 https://myaccount.google.com/security
    2. 选择 “2-Step Verification / 两步验证” 并按引导完成(常见方式:Google Prompt、Authenticator、短信等)
  • 获取 App Password(应用专用密码):
    1. 确认两步验证已开启后,打开:https://myaccount.google.com/apppasswords
    2. 在 “Select app / 选择应用” 里选 “Mail / 邮件”(或选 “Other / 其他” 自定义一个名字)
    3. 在 “Select device / 选择设备” 随便选一个(只影响显示名,不影响实际可用性)
    4. 点击 “Generate / 生成”,复制得到的 16 位 App Password
    5. 把这 16 位字符串作为上面 password 字段的值(不需要再输入 Google 账号密码)
  • Google Workspace(公司/学校域名账号)注意:
  • Workspace 官方帮助页提到,自 2025 年 5 月 1 日起,Workspace 账号不再支持只用账号密码给第三方应用登录
  • 另外,部分 Workspace 组织会在管理员侧禁用 App Password 或强制更严格的登录策略;若你在 https://myaccount.google.com/apppasswords 看不到入口或无法生成,优先走 OAuth2(见下方“方案 B”)

方案 B:OAuth2

现在已经支持完整的 Google OAuth 浏览器授权。当前实现方式是:

  • 你在 Google Cloud Console 创建 OAuth Client
  • 先创建一个 auth_type=oauth2 的 Gmail 账号配置
  • 打开 /oauth/google/start?account_id=...
  • 浏览器完成 Google 授权后,服务端自动保存 refresh_token
  • 服务端运行时自动换取 access_token
  • IMAP / SMTP 使用 XOAUTH2 登录 Gmail

OAuth2 账号示例:```json
{
"id": "gmail-oauth",
"provider": "gmail",
"email_address": "your-name@gmail.com",
"display_name": "Your Name",
"auth_type": "oauth2",
"oauth2": {
"provider": "google",
"client_id": "your-google-client-id",
"client_secret": "your-google-client-secret",
"scopes": [
"https://mail.google.com/"
]
}
}


然后访问:```text
http://localhost:8080/oauth/google/start?account_id=gmail-oauth

Google 回调成功后,账号文件里会自动写入:

  • refresh_token
  • access_token
  • token_expiry

最短跑通步骤

  1. 在 Google Cloud Console 创建 OAuth Client
  2. 在 Google OAuth consent screen 里把自己加入测试用户
  3. 把回调地址加入 Authorized redirect URIs:
    - http://localhost:8080/oauth/google/callback
  4. 运行初始化命令:```bash
    go run ./cmd/email-mcp init-gmail-oauth \
    --email your-name@gmail.com \
    --client-id your-google-client-id \
    --client-secret your-google-client-secret

5. 启动 HTTP 服务:```bash
go run ./cmd/email-mcp serve-http --addr :8080 --public-base-url http://localhost:8080
  1. 浏览器打开:text http://localhost:8080/oauth/google/start?account_id=gmail-oauth

  2. 授权成功后,再测试:

  • email.account.test_connection
  • email.mailbox.list
  • email.message.send

Gmail OAuth 所需字段

  • client_id
  • client_secret

推荐 scope:

  • https://mail.google.com/

当前限制

  • 账号凭证当前以本地 JSON 文件存储,适合开发阶段,不适合直接生产落地
  • 当前 Google OAuth 只实现了 Gmail
  • stdio 模式本身不能直接承载浏览器回调,所以第一次授权要通过 HTTP 模式完成
  • 还没有实现附件发送、回复、转发

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Email MCP Aa23846d 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Email MCP Aa23846d 收费吗?

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

Email MCP Aa23846d 需要 API Key 吗?

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

Email MCP Aa23846d 能提供哪些能力?

资料显示能力标签包括 邮件管理、Go、Gmail集成。具体工具清单以官方文档为准。

热门专题

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

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