用途:该项目是一个命令行工具 outlook-calendar-pp-cli,用于让智能体以非交互方式读写个人 Microsoft 365 日历,适合每日简报、安排会议、寻找空闲时间、查看变更、会前准备等任务;相比直接调用 Microsoft Graph,它提供冲突、空闲时间、重复事件漂移等需离线计算的能力。
主要能力:conflicts 查找所有日历中的重叠事件;freetime 按工作时段计算可用的 N 分钟空档;review 对比上次增量快照,列出新增、改期、取消或 RSVP 变化;pending 列出尚未回复的未来邀请;recurring-drift 找出偏离重复主模式的实例;with 统计与某人的会面频次与最近记录;tz-audit 找出时区异常事件;prep 汇总即将到来事件的详情。此外还有 events、calendars、categories、attachments、availability、delta 等子命令。
必要用法:先安装 CLI,npx -y @mvanhorn/printing-press-library install outlook-calendar --cli-only,或 go install github.com/mvanhorn/printing-press-library/library/productivity/outlook-calendar/cmd/outlook-calendar-pp-cli@latest,并确认可执行文件在 PATH 中;用 outlook-calendar-pp-cli --version 校验。首次使用运行 outlook-calendar-pp-cli auth login --device-code 完成 OAuth 设备码授权,令牌缓存于 ~/.config/outlook-calendar-pp-cli/config.toml,过期自动刷新。命令可加 --agent(等价 --json --compact --no-input --no-color --yes),支持 --select 精简字段、--dry-run 预览、--deliver 路由输出,退出码区分用法、未找到、鉴权、API、限流等错误。
适用场景与限制:适合个人 Microsoft 账户(Outlook.com、Hotmail、Live、MSA)以及智能体自动调度。availability 的 free/busy 查询在个人账户上受限,建议自用查询优先用 freetime;MCP 安装、二进制发布来源与具体平台差异资料未完整说明,需另行确认。