Outlook-Mail-MCP
家机的极简邮箱 MCP：连接一个 Outlook 邮箱，读取邮件并回复邮件。
🤝 Co-created by Lynn & Sage (ChatGPT)
这个项目由 Lynn 与 Sage（ChatGPT）共同设计、实现和调试。
这个项目只做三件事：
- 📬 查看最近邮件
- 📖 阅读邮件
- ↩️ 回复邮件
不做日历、不做网盘、不做 Power Automate，也不做多账号管理。
适用方案
本方案以 Render Web Service + Microsoft Outlook / Microsoft Graph + OAuth 2.0 为主要部署方式，适合把邮箱能力作为一个远程 MCP 服务提供给家机。
也可以在任何支持 Node.js、HTTPS 和持久化 Token 存储的环境中运行，但项目默认配置和部署文件以 Render 为准。
使用方式
部署到 Render 后，打开服务首页，点击 连接 Outlook 邮箱，完成 Microsoft 登录和授权。
授权完成后，把 MCP 地址 https://你的服务地址/mcp 接到家机即可。
Microsoft 配置
在 Microsoft Entra / Azure App Registration 创建一个应用，并启用以下 Delegated permissions：
openidprofileoffline_accessUser.ReadMail.ReadMail.ReadWriteMail.Send
Redirect URI 使用：
https://你的服务地址/auth/callback
应用类型选择 Web。
环境变量
MS_CLIENT_ID=你的 Application (client) ID
MS_CLIENT_SECRET=你的 Client Secret VALUE
MS_TENANT_ID=common
TOKEN_DIR=/data
在 Render 上，服务器会优先使用 PUBLIC_URL，否则使用 Render 自动提供的 RENDER_EXTERNAL_URL 生成 OAuth 回调地址。
Render 部署
仓库已经包含 render.yaml，可以直接使用 Render Blueprint 部署。
Render 配置包含：
- Node.js Web Service
/health健康检查- 1 GB 持久化磁盘
/dataToken 存储目录- Microsoft OAuth 所需环境变量
Token 保存在 Render 持久化磁盘中，不会提交到 GitHub。
MCP 工具
| 工具 | 作用 |
|---|---|
list_emails |
查看最近邮件 |
read_email |
阅读指定邮件 |
reply_email |
回复指定邮件 |
本地运行
npm install
npm start
默认地址：http://localhost:3000/。
本地 OAuth 回调：http://localhost:3000/auth/callback。
安全
OAuth 密码不会交给家机。Microsoft 登录完成后，服务只保存 OAuth token；Token 文件权限设置为仅当前进程用户可读写。
Credits
Lynn × Sage（ChatGPT） 一个人类开发者 + 一个 AI 搭档，一起把这个小工具蹬出来。 🫳
