内容
# Outlook 代理工具
**让您的 AI 助手读取和撰写电子邮件和日历 - 只需询问。**
设置完成后，您可以对 AI 助手说类似 *"明天我的日历上有什么?"*、*"总结我的未读邮件,"* 或 *"回复银行的最后一封邮件"* - 它实际上会为您执行这些操作，在您的真实邮箱中。
它适用于 Windows，设置大约需要 5-10 分钟，并且所有操作都保留在您自己的计算机上。
---
## 为什么这很方便
**开箱即用 - 无需登录。**
大多数连接工作邮箱的工具都需要您经历企业登录屏幕、从 IT 部门获取批准或生成特殊的“应用程序密码”。这个工具跳过了所有这些。它通过您已经打开并登录的 **Outlook 应用程序** 静默工作 - 因此无需登录其他内容。
**跨所有账户工作 - 工作和个人账户。**
因为它建立在 Outlook 之上，所以它适用于您添加的所有账户 - 一个 **工作 Exchange** 邮箱、一个个人 **Outlook.com** 账户、一个您添加到 Outlook 的 **Gmail** 账户，等等。AI 助手与 Outlook 通信；Outlook 处理每个电子邮件提供商。您无需设置特定于提供商的内容。
> 只需询问助手 *"我的 Outlook 账户是什么?"* 然后指向其中一个账户 - *"检查我的个人收件箱"* 或 *"我的工作日历中有什麼?"* 如果您不指定账户，它将使用您的默认 Outlook 账户。
**没有任何内容离开您的计算机，并且在执行任何风险操作之前会询问。**
没有任何密码或令牌存储在任何地方。读取邮件和日历在本地进行。在助手 **发送、回复、移动或删除** 任何内容之前，它会显示即将执行的操作并等待您的确认。
---
## 您会看到的一些术语（用简单语言解释）
- **AI 助手 / "代理"** - 您聊天的应用程序，它可以为您执行操作（Codex、Claude、Antigravity）。此软件包将您的电子邮件和日历连接到它。
- **"连接工具"** - 为您的助手提供新能力。在这里，新能力是“使用我的 Outlook”。
- **MCP** - 只是一个标准插件，允许助手使用外部工具。您不需要了解它；设置会为您配置它。
- **Outlook 经典版** - 适用于 Windows 的传统 Outlook **桌面程序**（不是网站，也不是较新的“新 Outlook”应用程序）。此工具需要它打开并登录。
---
## 您需要什么
- 一台 **Windows** 计算机。
- **Outlook 经典桌面应用程序**，已安装并登录（只需打开它一次，并确保您的邮件和日历显示）。
- 以下 AI 助手之一。
就是这样 - 无需安装其他软件。
---
## 设置 - 选择您的助手
下载此文件夹，打开适用于您助手的子文件夹，然后 **双击 `setup.bat`**。它将引导您完成其余的操作。（如果 Windows 显示蓝色“Windows 保护了您的电脑”框，请单击 **更多信息 → 运行任何方式** - 这只是因为文件来自互联网。）
| 您的助手 | 打开此文件夹 | 它添加的电子邮件 + 日历 |
|---|---|---|
| **Codex** | [`clients/codex`](clients/codex) | Outlook **+ Gmail + Google 日历** |
| **Claude Code** | [`clients/claude-code`](clients/claude-code) | Outlook |
| **Claude 桌面版** | [`clients/claude-desktop`](clients/claude-desktop) | Outlook |
| **Antigravity** | [`clients/antigravity`](clients/antigravity) | Outlook |
每个子文件夹都有自己的简短 README 文件，其中包含分步说明。Gmail 和 Google 日历是 **Codex** 独有的额外奖励（它具有内置的连接器）；在其他助手上，此软件包仅关注 Outlook。
您可以随时重新运行设置 - 它是安全的，不会破坏任何内容。
---
## 需要注意的事项
- 设置会备份任何更改的设置文件（保存在原始文件旁边），因此不会丢失任何内容。
- 如果 Outlook 显示 *"未连接,"* 只需打开 Outlook 桌面应用程序，登录，然后重试。它需要 Outlook 正在运行。
- 它仅在您的计算机上设置您的账户。
---
<details>
<summary><b>技术细节</b>（适用于好奇的人或手动设置）</summary>
### 工作原理
Outlook 部分是一个用 PowerShell 编写的 **MCP 服务器**，通过 COM 自动化驱动 **Outlook 经典桌面应用程序**。它在您已经登录的 Outlook 配置文件的上下文中运行，因此：
- **无需 OAuth、应用程序注册、客户端密钥或令牌。**
- **无需管理员同意 / 条件访问墙**，而 Microsoft Graph 连接器会在锁定工作租户时遇到这种情况。
- 提供程序无关且 **多账户**：它可以通过可选的 `account` 参数针对 MAPI 配置文件中的任何存储（Exchange、Outlook.com、IMAP/Gmail 账户添加到 Outlook 等）；如果未指定账户，它将默认为默认存储或配置的 `defaults.defaultAccount`。
- 快速且支持离线（本地，无需网络跳转）。仅限 Windows + Outlook 经典版 - 不支持网络邮件或“新 Outlook”。
### 安全模型
读取操作自由执行；变异操作则需授权。对于 **Codex**，安装程序会在每个写入工具上设置 `approval_mode = "approve"`（`outlook_mail_send/reply/forward/move`，`outlook_calendar_create/update/delete_event`）。对于 **Claude Code / 桌面版 / Antigravity**，客户端本身会在每次调用工具之前提示授权。服务器还支持草稿优先模式（`OUTLOOK_MCP_REQUIRE_DRAFT=1`），完全阻止一次性发送/创建。
### Outlook MCP 工具
邮件：`outlook_mail_list_folders`、`outlook_mail_list_messages`、`outlook_mail_count_messages`、`outlook_mail_read_message`、`outlook_mail_send`、`outlook_mail_reply` / `outlook_mail_draft_reply`、`outlook_mail_forward` / `outlook_mail_draft_forward`、`outlook_mail_draft_send` / `outlook_mail_send_draft`、`outlook_mail_move`、`outlook_mail_mark`。
日历：`outlook_calendar_list`、`outlook_calendar_list_events`、`outlook_calendar_get_event`、`outlook_calendar_create_event` / `outlook_calendar_draft_event` + `outlook_calendar_send_event`、`outlook_calendar_update_event`、`outlook_calendar_delete_event`、`outlook_calendar_free_busy`、`outlook_calendar_find_slots`、`outlook_calendar_schedule_batch`。
账户/人员/状态：`outlook_accounts_list`（列出每个账户的名称、SMTP 和默认标志）、`outlook_resolve_people`、`outlook_status`。邮件/日历读取工具接受可选的 `account` 参数（名称或 SMTP）以针对特定账户。参见 [`skills/outlook-cli/references/cli-contract.md`](skills/outlook-cli/references/cli-contract.md)。
### 手动设置（任意 MCP 客户端）
该工具是一个由 PowerShell 启动的标准输入/输出 MCP 服务器。指向任何客户端的 `outlook-cli\outlook-cli.ps1 mcp serve`（将路径替换为 `outlook-cli` 文件夹的位置）。JSON 客户端（Claude Code/桌面版，Antigravity）：
```json
{
"mcpServers": {
"outlook": {
"command": "powershell",
"args": ["-ExecutionPolicy", "Bypass", "-NoProfile", "-File", "C:\\Users\\<you>\\dev\\outlook-cli\\outlook-cli.ps1", "mcp", "serve"]
}
}
}
```
Codex (`~/.codex/config.toml`)：
```toml
[mcp_servers.outlook]
command = "powershell"
args = ["-ExecutionPolicy", "Bypass", "-NoProfile", "-File", "C:\\Users\\<you>\\dev\\outlook-cli\\outlook-cli.ps1", "mcp", "serve"]
```
### 仓库布局
```
outlook-agent-pack/
├── README.md # 此文件
├── LICENSE # MIT
├── outlook-cli/ # 共享 Outlook MCP 工具（PowerShell，COM）
├── skills/outlook-cli/ # 共享代理技能（SKILL.md + 脚本）
├── lib/common.ps1 # 共享安装程序帮助程序
└── clients/
├── codex/ # setup.bat + setup.ps1 + ONBOARDING.md + README
├── claude-code/ # setup.bat + setup.ps1 + README
├── claude-desktop/ # setup.bat + setup.ps1 + README
└── antigravity/ # setup.bat + setup.ps1 + README
```
安装程序将工具复制到 `%USERPROFILE%\dev\outlook-cli`，设置默认时区，导出 `OUTLOOK_CLI_REPO`，在支持的平台上安装技能，并且是幂等的 + 配置保留（每个触摸的配置都会先备份）。
</details>
---
## License
MIT - 请参阅 [LICENSE](LICENSE)。版权所有 (c) 2026 Otto Becker。免费使用、修改和分享。
