Email-AI-MCP
Manages a Cloudflare Tunnel (quick or named) from the daemon to expose the local web console over HTTPS, giving the user a public URL so the console can be reached from a phone browser.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

Email-AI-MCP 是一个 MCP Server。Devin(或其他支持 MCP 的 AI 编码代理)完成任务后,通过它把完整的任务总结发到你的 QQ 邮箱;你在手机上直接回复这封邮件,回信会被自动识别出属于哪个对话,并投递回原来那个 Devin 对话继续执行。配套的 Web 控制台可以查看所有会话的历史记录、把回信改派给别的会话、直接下达指令,通过 Cloudflare 隧道在手机上也能访问。
截图中的会话、邮箱、路径均为演示数据。
核心功能
完整总结邮件:任务总结、详情、下一步建议全部按 Markdown 渲染(标题、列表、表格、代码块、引用),不截断、不限高;正文统一 15px,手机宽度自适应;跟随系统自动切换白天/黑夜;内置 5 套版式可选。
回信按会话投递:通知邮件自动绑定发出它的 Devin 会话——直接只读 Devin 本地会话库,找到发起这次调用的那条消息所属的会话,多个会话同时运行也不会绑错;回信按
In-Reply-To/ 主题标记路由回该会话。桌面端精确注入:注入器自动切换到目标对话标签(支持未加载标签、历史对话列表、标签被改名)再粘贴发送;会话正在运行时用 Ctrl+Enter 排队,不打断也不卡住;输入框有你的草稿时暂缓投递,投递后恢复你的剪贴板。
投递状态机:每条回信/指令都有
待投递 → 投递中 → 已投递 / 已挂起 / 失败 / 已忽略状态;找不到会话时挂起并每 2 分钟自动重试,也可在网页随时改派。Web 控制台:会话列表、聊天记录式时间线(通知靠左、回信靠右)、全局搜索与筛选、待处理队列、改派并发送、直接下达指令、预览原邮件;白天/黑夜/跟随系统三态主题;手机端抽屉布局。
手机访问:守护进程托管 Cloudflare 隧道,自动获得 https 地址;邮件里的"在网页查看"链接自带 7 天有效的签名登录票据,点开即进,邮件里不出现固定令牌。
稳定运行:后台服务通过 WMI 启动,不随 IDE 重启被连带杀掉;MCP 每 30 秒自检、自动拉起;多进程共用跨进程文件锁读写状态,IMAP 按 UID 水位增量收信不漏信。
Related MCP server: Joxo
许可证与使用
本项目采用 CC BY-NC 4.0(署名-非商业性使用 4.0 国际)发布,详细说明见 NOTICE.md。
场景 | 是否允许 |
个人学习、研究、自用 | ✅ |
修改代码、二次开发(需注明来源并说明改动) | ✅ |
非商业转载、分享(需注明来源) | ✅ |
出售源码或安装包、作为付费服务 / SaaS 提供 | ❌ |
集成到收费产品、商业接单交付 | ❌ |
去掉署名后以自己名义发布 | ❌ |
魔改或转载时请显著标注:本项目基于 Email-AI-MCP(https://github.com/FreeNAP/Email-AI-MCP)修改。商业使用请先通过 Issues 联系取得书面授权。
项目功能流程
所有流程图默认折叠,点击标题展开。
flowchart LR
DEVIN["Devin 完成任务"] --> NOTIFY["调用 notify_devin_event<br/>标题 + 完整总结 + 详情"]
NOTIFY --> BIND["识别发信会话<br/>只读 Devin 会话库"]
BIND --> SMTP["渲染邮件并经 SMTP 发出<br/>主题带 [AI-CONV:会话ID]"]
SMTP --> PHONE["手机收到邮件<br/>阅读完整总结"]
PHONE --> REPLY["直接回复邮件"]
REPLY --> IMAP["守护进程 IMAP 收信<br/>按 UID 增量拉取"]
IMAP --> ROUTE["按 In-Reply-To / 主题标记<br/>路由到原会话"]
ROUTE --> INJECT["注入器切到对应对话标签<br/>粘贴并发送"]
INJECT --> DEVINflowchart TB
START["发送通知"] --> E{"调用方显式传了<br/>sessionId / conversationId?"}
E -->|是| EXPLICIT["直接使用(explicit)"]
E -->|否| DB["在 Devin 会话库最近消息里<br/>找标题和总结一致的那次调用"]
DB -->|找到| DEVINDB["绑定该会话(devin-db)"]
DB -->|会话库不可用| RECENT["取最近 180 秒内有活动的会话<br/>(recent-activity)"]
RECENT -->|没有| NONE["不绑定,回信按 unboundPolicy 处理"]stateDiagram-v2
[*] --> 待投递: 收到回信 / 网页下达指令
待投递 --> 投递中: 注入器领取
投递中 --> 已投递: 发送成功(运行中则排队)
投递中 --> 待投递: 输入框有草稿,稍后再试
投递中 --> 已挂起: 桌面端找不到会话
投递中 --> 失败: 窗口/输入框异常
已挂起 --> 投递中: 每 2 分钟自动重试
失败 --> 投递中: 退避重试(最多 5 次)
已挂起 --> 待投递: 网页改派
失败 --> 待投递: 网页改派
待投递 --> 已忽略: 网页忽略
已投递 --> [*]flowchart TB
IDE["Devin Desktop / MCP 客户端"] --> MCP["MCP Server(dist/index.js)<br/>工具调用、发信、每 30 秒自检"]
MCP -->|WMI 启动,脱离 IDE 进程树| DAEMON["守护进程(dist/daemon.js)<br/>单例锁"]
DAEMON --> POLL["IMAP 收信"]
DAEMON --> WEB["Web 控制台 127.0.0.1:8765"]
DAEMON --> INJ["注入器 scripts/mail_injector.py<br/>子进程,异常退避重启"]
DAEMON --> CF["cloudflared 隧道<br/>子进程,异常退避重启"]
CF --> PHONE["手机浏览器 https"]
MCP & DAEMON & INJ --> STATE[("data/state.json<br/>跨进程文件锁 + 原子写")]运行环境
依赖 | 版本 | 说明 |
Windows | 10 / 11 | 桌面注入依赖 Windows UI 自动化;其他系统可用 |
Node.js | 22.5+ | 需要内置 |
Python | 3.9+ | 注入器, |
QQ 邮箱 | 开启 SMTP/IMAP | 使用授权码,不是 QQ 登录密码 |
cloudflared | 可选 | 手机访问控制台;官方发布页 下载 |
快速开始
git clone https://github.com/FreeNAP/Email-AI-MCP.git
cd Email-AI-MCP
npm install
npm run build
pip install uiautomation pyperclip
cp config.example.yml config.yml # 首次运行也会自动生成编辑 config.yml,至少填写:
mail:
recipients: ["你的收件邮箱@qq.com"]
allowedReplyFrom: ["你的收件邮箱@qq.com"] # 只有白名单发来的回信才会被当作指令
smtp:
enabled: true
user: "发信邮箱@qq.com"
pass: "SMTP 授权码"
imap:
enabled: true
user: "发信邮箱@qq.com"
pass: "IMAP 授权码"在 MCP 客户端中注册(路径换成你的项目目录):
{
"mcpServers": {
"email-ai-mcp": {
"command": "node",
"args": ["D:/path/to/Email-AI-MCP/dist/index.js"],
"env": { "EMAIL_AI_MCP_CONFIG": "D:/path/to/Email-AI-MCP/config.yml" }
}
}
}重启客户端后,MCP Server 会自动拉起守护进程、注入器和 Cloudflare 隧道。控制台地址 http://127.0.0.1:8765/,访问令牌见 config.yml 的 web.token(留空则自动生成到 data/web-token.txt)。
建议在 AI 代理的规则里加上一句:完成任务后调用 notify_devin_event 发送完整任务总结,或使用 injector.systemReminder 自动附加。
首次配置顺序
QQ 邮箱 → 设置 → 账户 → 开启 IMAP/SMTP 服务,生成授权码;
填写
config.yml的mail/smtp/imap,调用verify_mail_connection工具校验连通;让 Devin 发一封测试通知,确认邮件排版与"在网页查看"链接;
直接回复这封邮件,在控制台看它从"待投递"变为"已投递";
需要固定域名时,在 Cloudflare 后台创建 tunnel,把 token 填到
web.tunnel.tunnelToken、mode: named,域名填到web.publicUrl。
主要配置项
配置 | 说明 |
| 邮件版式: |
| 邮件配色: |
| 投递目标: |
| 未绑定会话的回信: |
| 投递时附加在指令末尾的提醒 |
| 控制台固定令牌 / 邮件自动登录票据有效天数(0 为不带) |
| Cloudflare 隧道: |
| 会话自动识别、Devin 会话库路径、活动时间窗 |
MCP 工具
工具 | 用途 |
| Devin 任务完成/失败/启动/暂停时发送通知邮件,自动绑定会话 |
| 通用任务事件通知(todo 完成、卡住、token 不足等) |
| 发送自定义邮件 |
| 查看邮件指令队列(注入器运行时只返回概况,避免被其他会话误领) |
| 手动拉取回信、标记已消费 |
| 运行状态与 SMTP/IMAP 连通性校验 |
目录与文件用途
路径 | 内容 |
| MCP Server 入口:注册工具、WMI 拉起守护进程、30 秒自检 |
| 守护进程:IMAP 收信、Web 控制台、注入器与隧道的进程监护 |
| SMTP 发信、IMAP 收信(UID 水位)、Markdown 邮件模板与 5 套版式 |
| Devin 会话列表与会话库只读查询、历史通知回填 |
|
|
| 控制台 HTTP API、登录票据、公网地址、视图模型 |
| MCP 工具实现 |
| 单文件控制台前端(原生 JS,零依赖) |
| 桌面注入器:切换对话标签、草稿检测、投递状态机 |
| 通过 WMI 启动脱离 IDE 进程树的后台进程 |
| Node |
| 配置模板(含每一项的中文注释) |
页面展示
5 套通知邮件版式(mail.design):

数据与安全
控制台只监听
127.0.0.1,公网访问必须经 Cloudflare 隧道;所有接口需登录,写操作校验同源,登录失败按 IP 限流;邮件里的自动登录链接是带有效期的 HMAC 签名票据,不包含固定令牌;更换令牌后旧票据全部失效;
只接受
allowedReplyFrom白名单发来的回信;渲染邮件与网页时所有文本先转义,链接只放行http/https/mailto;读取 Devin 会话库只用只读模式,不写入;
config.yml、data/已在.gitignore中,切勿提交授权码。
验证
npm run typecheck
npm test # 构建后运行 Node 与 Python 全部测试测试覆盖:5 套邮件版式 × 3 种主题的字号规格、不截断与防注入;多进程并发写状态文件;Web 接口鉴权、改派、翻页与登录票据;Devin 会话库识别;注入器状态机、标签匹配与草稿检测。
致谢
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Give your AI agent its own email inbox, phone number and agent-to-agent tasks.
Task-scoped email inboxes for AI agents: read mail, extract verification codes, and reply.
Email inboxes for AI agents: send, reply, read verification codes, human-approved drafts.
Give your AI assistant its own email inbox: send, read and catch sign-in codes. Texting coming soon.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage complex development workflows by creating structured handoffs between strategic planning and tactical implementation, with project management, task tracking, and intelligent scaffolding.16 npmMIT
- FlicenseAqualityBmaintenanceOne shared project for your team's Claude Code, Codex, Cursor and OpenCode agents: a task board, decisions and handoffs. Everyone keeps their own plan.1357-
- AlicenseNot gradedqualityCmaintenanceGives AI coding agents native tools to pull their next prioritized, unblocked task with a full briefing (description, acceptance criteria, context files, conventions), comment and tick off criteria with evidence, ask the human decision-maker questions, and submit structured handoffs for review. It lets agents plan epics and sprints, report checks, create new tasks, and release work with checkpoints — all against a self-hosted board rather than files in the repo.1MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI coding agents to file reviews and call real human reviewers mid-task, returning comments pinned to the exact elements that are off so the agent can iterate until a person approves the work.38 npmMIT