用途:该技能用于通过 Bun 执行 TypeScript 脚本调用 Microsoft Graph API,访问 Microsoft 365 的邮件与日历,适用于读取邮件、发送邮件、查看与创建日历事件等场景。
主要能力:邮件方面支持列出、阅读、搜索邮件,列出邮件文件夹,以及发送邮件(支持多收件人、CC、BCC、HTML 正文)。日历方面支持列出即将到来的事件、查看今天或本周日程、查看指定事件、搜索事件,以及创建事件(可设置开始/结束时间、地点、描述、参会者、全天事件)。所有脚本输出统一 JSON,结构包含 status 字段(success、auth_required、auth_pending、error)。
使用方式:脚本位于 ${CLAUDE_PLUGIN_ROOT}/skills/microsoft-graph/scripts/。常用命令如:bun run emails.ts list、bun run emails.ts search --query "from:boss@company.com"、bun run emails.ts send --to "user@example.com" --subject "Hello" --body "Hi there!"、bun run calendar.ts today、bun run calendar.ts create --subject "Team Meeting" --start "2024-01-15T14:00:00"。日期支持 today、tomorrow、+7d、+1m、+1y 等相对格式及 ISO 格式。认证采用设备码方式,收到 auth_required 时需引导用户访问 https://microsoft.com/devicelogin 并输入 userCode。支持通过 --profile 参数使用多账号,auth.ts 可列出或删除 profile,也可用自定义 Azure AD 应用认证。
限制:需要 Bun 运行环境;访问令牌约 1 小时自动刷新,刷新令牌约 90 天,过期后需重新认证;凭据存储于 ~/.config/api-skills/credentials.json。关于 API 端点与参数的详细信息可参考 references/graph-api.md。资料未提供收费、价格或平台支持范围等信息。