用途:通过 Microsoft Graph API 与 OAuth2 访问 Outlook/Hotmail 的邮件和日历,适合在对话中读取、搜索和管理邮件及日程。
主要能力:邮件方面支持列出收件箱、未读邮件、按关键词或发件人搜索、读取正文与附件、标记已读/未读、加旗标、删除、归档、移动文件夹、发送与回复,并可查看文件夹和收件箱统计。日历方面支持查看今日、本周及即将到来的事件、读取事件详情、列出日历、查询空闲时间,以及创建、快速创建、更新和删除事件。
使用方式:需先完成 OAuth2 授权。自动安装需 Azure CLI 与 jq,运行 ./scripts/outlook-setup.sh,脚本会登录 Azure、创建应用注册、配置权限(Mail.ReadWrite、Mail.Send、Calendars.ReadWrite)并保存凭据到 ~/.outlook-mcp/。也可参考 references/setup.md 手动配置。常用命令包括 ./scripts/outlook-token.sh refresh|test|get、./scripts/outlook-mail.sh inbox|unread|search|read|send|reply 等,以及 ./scripts/outlook-calendar.sh events|today|week|create|update|delete 等。日期格式为 YYYY-MM-DDTHH:MM。
限制:访问令牌约 1 小时后过期,需运行 outlook-token.sh refresh 刷新;read、mark-read 等命令只在最近 100 封邮件中查找 ID;工作/学校账户可能需要管理员同意;文件夹名需精确匹配。支持个人账户(outlook.com、hotmail.com、live.com)与 Microsoft 365 账户。