# 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：

- `openid`
- `profile`
- `offline_access`
- `User.Read`
- `Mail.Read`
- `Mail.ReadWrite`
- `Mail.Send`

Redirect URI 使用：

```text
https://你的服务地址/auth/callback
```

应用类型选择 **Web**。

## 环境变量

```text
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 持久化磁盘
- `/data` Token 存储目录
- Microsoft OAuth 所需环境变量

Token 保存在 Render 持久化磁盘中，不会提交到 GitHub。

## MCP 工具

| 工具 | 作用 |
| --- | --- |
| `list_emails` | 查看最近邮件 |
| `read_email` | 阅读指定邮件 |
| `reply_email` | 回复指定邮件 |

## 本地运行

```bash
npm install
npm start
```

默认地址：`http://localhost:3000/`。

本地 OAuth 回调：`http://localhost:3000/auth/callback`。

## 安全

OAuth 密码不会交给家机。Microsoft 登录完成后，服务只保存 OAuth token；Token 文件权限设置为仅当前进程用户可读写。

---

### Credits

**Lynn × Sage（ChatGPT）**  
一个人类开发者 + 一个 AI 搭档，一起把这个小工具蹬出来。 🫳