核心用法
outlook-mcp 是一款面向个人 Microsoft 账号（Outlook.com / Hotmail / Live）的生产级 MCP 服务端，通过 Microsoft Graph API 为 AI Agent 提供完整的 Outlook 数据访问能力。不同于简单的 CLI 包装器，该项目实现了 61 个类型化工具，覆盖邮件收发、日历管理、联系人维护、待办事项、草稿处理、附件操作、文件夹管理、会话线程、批量操作及邮箱设置等全场景功能。
部署需先注册免费 Azure 账号并创建 Azure AD 应用，获取 client_id 后配置 ~/.outlook-mcp/config.json，支持 read_only 只读模式及细粒度权限类别（如 calendar_write、mail_write 等 8 类）。认证采用 CLI 交互式流程（outlook-mcp auth），令牌存储于系统密钥环（macOS Keychain / Windows Credential Store），无本地缓存。
显著优点
- 功能完整性：61 个工具覆盖 Outlook 核心工作流，包括 Focused Inbox 管理、邮件分类、批量处理（batch triage）、KQL 搜索、大型附件自动分片上传等高级特性
- 企业级安全设计：BYOID（自带身份）架构，用户自建 Azure AD 应用，无共享 client_id；OS 级密钥环存储；零遥测、零本地缓存
- 权限粒度控制：支持 8 类细粒度权限策略，可从只读逐步放开到特定功能域
- 生产优化：
/$batch批量接口优化、线程级操作、自动回复/时区设置等邮箱管理能力
潜在缺点与局限性
- 仅限个人账号：明确不支持企业/学校 Entra ID 账号，职场用户受限
- 前置门槛较高：需注册 Azure 账号并创建 AD 应用，对非技术用户有学习成本
- CLI 预认证：必须在宿主终端手动执行 auth 流程，无法通过 MCP 工具内完成交互认证
- Python 3.10+ 依赖：基于 uv 包管理器，环境要求较新
适合人群
- 技术背景的个人用户，希望让 AI Agent 深度接管 Outlook 工作流
- 隐私敏感用户，要求数据自主可控、无第三方服务中转
- 需要细粒度权限管理的场景（如仅开放日历写入而保持邮件只读）
常规风险
- 令牌泄露风险：虽存储于 OS 密钥环，但宿主环境若被入侵仍存在横向移动风险
- 误操作风险：批量操作（
outlook_batch_triage）和永久删除功能可能造成数据丢失，建议始终开启read_only模式测试 - Azure 配置风险：错误的权限配置或应用注册信息可能导致账号异常或 API 访问受限