用途：m365-calendar 是一个命令行工具，通过 Microsoft Graph API 读取、创建和管理 Microsoft 365 日历事件。
主要能力：查看今天、明天、未来 7 天或指定日期区间的事件；查看事件详情；创建简单事件、带地点事件、带参会人事件（自动发送邀请）、Teams 会议和全天事件；更新事件（改主题、时间、地点等，对带参会人的事件会自动发送更新通知）；删除或带留言取消事件；接受、暂定或拒绝邀请；列出日历（支持 JSON 输出）。创建或更新带参会人的事件时，Graph 会自动发送会议邀请邮件、将事件加入参会人日历并发送变更或取消通知，无需另外使用 m365mail。
使用方式：需先在 Entra ID 应用中授予 Calendars.ReadWrite（委托）权限。日历工具共享 m365mail 的客户端与租户配置，须先完成 m365mail 设置，再执行 m365cal auth 完成设备码授权。常用命令如 m365cal today、m365cal week、m365cal range 2024-01-15 2024-01-20、m365cal create -s "Team standup" --start "2024-01-15 09:00" -d 30、m365cal update <event_id> --subject "New title"、m365cal delete <event_id>、m365cal respond <event_id> accept。选项包括 --json、-d/--duration（默认 60 分钟）、-a/--attendees、-o/--optional、-t/--teams、-l/--location、-b/--body、-v/--verbose。事件 ID 可用完整 ID 或前 8 位以上前缀。
适用场景：需在脚本或终端中快速管理 M365 日程、批量创建会议并自动邀请参会人的场景。
限制：依赖已配置的 m365mail 与 Entra ID 权限；令牌缓存于 ~/.m365calendar/token_cache.json，配置位于 ~/.m365mail/config.json。若提示无缓存令牌需运行 m365cal auth，提示先运行 m365mail setup 需先配置邮件，权限被拒需确认已授予 Calendars.ReadWrite。