核心功能
Outlook Skill 是一款基于 Microsoft Graph API 的命令行工具,为个人和企业用户提供完整的邮箱与日历管理能力。通过 OAuth2 认证机制,用户可在终端环境中高效处理邮件收发、日程安排、事件创建等日常办公任务。
核心能力矩阵
邮件管理:支持收件箱浏览、未读邮件筛选、关键词搜索、按发件人过滤等基础操作;提供标记已读/未读、重要性标记、归档、删除、移动文件夹等管理功能;支持发送新邮件、回复邮件及附件列表查看。
日历功能:涵盖日程查询(今日/本周/自定义范围)、事件详情查看、空闲时间检测;支持快速创建事件、更新事件属性(主题/地点/时间)、删除事件及多日历管理。
自动化集成:提供一键式 Azure 应用注册脚本,自动配置 API 权限(Mail.ReadWrite、Mail.Send、Calendars.ReadWrite);token 自动刷新机制支持长期会话保持。
显著优势
- 纯 CLI 工作流:无需图形界面,适合开发者与服务器环境
- JSON 结构化输出:便于与其他工具链集成(jq、Python 等)
- 智能 ID 处理:使用邮件 ID 后缀简化命令输入
- 企业级兼容:同时支持个人 Microsoft 账户(Outlook/Hotmail)和 Microsoft 365 工作账户
局限性与注意事项
- token 有效期限制:访问 token 约 1 小时过期,需手动刷新
- ID 搜索范围:部分命令仅检索最近 100 封邮件,老旧邮件需先搜索定位
- 管理员授权要求:Microsoft 365 企业环境可能需要 IT 管理员预授权
- HTML 转文本:邮件正文自动转为纯文本,复杂格式可能丢失
适用人群
- 需要批量处理邮件的开发者和运维人员
- 偏好终端工作流的高效办公用户
- 希望将邮件/日程操作脚本自动化的 Microsoft 生态用户
- 需要集成 Outlook 数据到自建工作流的技术团队
安全风险提示
- 凭证本地存储:OAuth token 和客户端密钥保存在
~/.outlook-mcp/目录,需确保文件权限正确设置 - 权限范围较宽:默认申请 Mail.ReadWrite 和 Calendars.ReadWrite,具备删除邮件和日历的完整写权限
- 设备代码流依赖:自动化脚本使用 Azure CLI 设备登录,在共享环境中需注意登录会话安全