核心功能
outlook-mcp 是面向 AI Agent 的生产级 MCP 服务器,专为个人 Microsoft 账户(Outlook.com/Hotmail/Live)设计,通过 Microsoft Graph API 提供完整的 Outlook 数据访问能力。不同于简单的 CLI 包装器,该工具原生集成了 54 个类型安全的工具,覆盖六大核心模块:
邮件管理:收件箱列表、消息读取、KQL 搜索、发送/回复/转发、草稿全生命周期管理、线程追踪、批量整理(移动/标记/分类/删除)、附件上传下载(支持 >3MB 大文件自动分片上传)。
日程与任务:日历事件 CRUD、循环事件展开、与会者 RSVP、待办列表管理、任务优先级与截止日期设置。
联系人管理:完整的联系人增删改查与搜索功能。
文件夹与元数据:自定义文件夹创建/重命名、邮件分类标签管理、多账户切换、邮件发送前检查(OOF 状态、投递限制)。
显著优点
- 企业级权限设计:支持
read_only全局只读模式,更可通过allow_categories细粒度控制 7 类操作权限(如仅允许日历写入) - 安全认证架构:Token 存储于 OS 密钥环(macOS Keychain/Windows Credential Store),零本地缓存、零遥测
- BYOID 模式:用户自建 Azure AD 应用,无共享 Client ID,彻底隔离数据
- 生产优化:
/$batch批量操作接口、自动大附件上传会话、Graph API 原生调用
潜在局限
- 账户类型限制:v1 版本仅支持个人微软账户,企业/学校 Entra ID 账户暂不可用
- 前置配置复杂:需注册免费 Azure 账户→创建 AD 应用→本地 CLI 认证,门槛高于一键 OAuth 方案
- 无交互式认证:必须通过主机终端运行
outlook-mcp auth完成授权,无法通过 MCP 工具流直接跳转浏览器 - 自托管责任:Azure 应用配额、密钥轮换、权限变更需用户自行维护
适用人群
- 需要 AI Agent 深度集成个人 Outlook 数据的高级用户
- 隐私敏感型用户(拒绝第三方托管 Token 或共享应用权限)
- 自动化邮件处理、日程管理、联系人维护的个人效率极客
- 具备基础 Azure 配置能力的开发者与技术用户
常规风险
- OAuth 配置风险:Azure AD 应用若配置不当(如重定向 URI 错误、权限过度申请)可能导致授权失败或安全隐患
- Token 泄露:尽管存储于系统密钥环,主机若被恶意软件控制仍存在泄露可能
- 误操作数据丢失:批量删除/移动工具(如
outlook_batch_triage)在关闭只读模式后可能造成不可逆操作 - API 限流:Microsoft Graph 存在请求配额,高频自动化场景需处理 429 错误