核心功能概述
outlook-mcp 是一个面向个人Microsoft账号的生产级MCP服务器,通过Microsoft Graph API为AI代理提供对Outlook核心服务的完整访问能力。与简单的CLI包装器不同,这是一个专为智能代理设计的原生集成方案,支持邮件、日历、联系人、待办事项、草稿、附件等全功能操作。
核心优势
1. 全面的功能覆盖
- 54个强类型工具,涵盖邮件收发、日历管理、联系人维护、待办事项、草稿处理、附件管理、文件夹操作、会话线程、批量处理等全场景
- 支持KQL高级邮件搜索、 recurring事件展开、Focus Inbox智能分类、邮件提示预检查等企业级功能
- 批量操作优化(
/$batchtriage),单次最多处理20条消息
2. 安全与隐私架构
- 零遥测设计:无数据收集、无本地缓存
- BYOID(自带身份):用户自行注册Azure AD应用,无共享客户端ID风险
- OS密钥环存储:令牌保存在系统级安全存储(macOS Keychain/Windows Credential Store)
- 细粒度权限控制:支持7大类别权限的独立开关(如仅允许日历写入)
3. 生产级设计
- 支持多账号切换、只读模式、时区配置
- 大附件自动分片上传(>3MB触发upload session)
- 完善的错误处理和类型安全
潜在局限
1. 账号类型限制
- 仅支持个人Microsoft账号(@outlook.com/@hotmail.com/@live.com)
- 企业/学校账号(Entra ID)暂不支持,这对商业用户是重大限制
2. 部署复杂度
- 需先注册免费Azure账号(约5分钟)
- 需手动创建Azure AD应用并配置回调URL
- 认证流程为CLI交互式,非MCP原生OAuth流程
3. 生态依赖
- 需配合
uv包管理器使用 - 依赖Microsoft Graph API的稳定性与速率限制
适用人群
- 个人效率用户:需要AI代理管理个人邮件日程的高级用户
- 开发者/技术爱好者:愿意配置Azure基础设施以获得完整控制
- 隐私敏感用户:重视数据主权、拒绝第三方托管方案
常规风险提示
- 邮件删除默认为软删除,但支持永久删除选项,需谨慎使用
- 日历操作可能影响真实会议邀请,建议在只读模式熟悉后再开启写入
- Azure AD应用注册需保管好客户端密钥,泄露可能导致账号被滥用
- Graph API调用受Microsoft速率限制,高频自动化场景需注意配额