微软技能
用于Microsoft Graph API集成的Claude Code插件,专注于OutlookHotmail电子邮件访问。
安装
将此插件添加到Claude Code:
claude mcp add-plugin /path/to/microsoft-skill或者添加到您的Claude代码配置中。
特性
- OAuth 2.0身份验证 使用PKCE
- 电子邮件操作:列出邮件,下载为
.eml - 安全存储:1密码或本地文件凭据
- 每个项目代币:每个项目有不同的Microsoft帐户
快速开始
安装后,当您询问电子邮件时,该技能会触发:
- “检查我的outlook收件箱”
- “阅读我的电子邮件”
- “从hotmail下载最近的邮件”
- “列出我的microsoft邮件”
首次设置
- 配置凭据:
pnpm tsx skills/microsoft-outlook/scripts/microsoft.ts setup- 验证:
pnpm tsx skills/microsoft-outlook/scripts/microsoft.ts auth- 验证:
pnpm tsx skills/microsoft-outlook/scripts/microsoft.ts me插件结构
microsoft-skill/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── skills/
│ └── microsoft-outlook/
│ ├── SKILL.md # Skill instructions
│ ├── scripts/ # CLI implementation
│ │ ├── microsoft.ts
│ │ └── lib/
│ └── references/ # Detailed documentation
│ ├── setup-guide.md
│ └── api-reference.md
├── package.json
└── README.md命令
| 命令 | 描述 |
|---|---|
setup | 配置API凭据 |
auth | 运行OAuth流 |
check | 验证身份验证状态 |
me | 获取用户资料 |
messages | 列出最近的消息 |
download | 将邮件下载为.eml |
download-all | 下载最近的消息 |
凭证设置
在中注册应用程序 微软Entra管理中心 或 Azure 门户:
- 登录:使用您的Microsoft帐户。如果您看到不在目录中的错误,请按照提示“注册Azure”(免费)创建默认目录。
- 应用程序注册 > 新注册
- 名字:
microsoft-skill-cli - 支持的帐户类型:选择 任何组织目录中的帐户(任何Microsoft Entra ID租户-多租户)和个人Microsoft帐户(例如Skype、Xbox).
- *注意:如果您想使用个人@outlook.com或@hotmail.com帐户,这是必需的。*
- 重定向URI:选择 网络 并进入
http://localhost:3000/callback. - 注册:单击按钮。
- 客户端ID:复制 应用程序(客户端)ID 从概述页面。
- 客户端密钥:
- 首选 证书和秘密 > 新客户机密. - 添加描述并单击 添加. - 复制 价值 (不是秘密ID)立即。
- API权限:
- 首选 API权限 > 添加权限. - 选择 微软图形 > 委托权限. - 添加 Mail.Read 和 User.Read. - (可选)单击 授予管理员同意 如果你是租户管理员。
存储选项
1密码 (推荐): 该脚本在您的 个人 拱顶:
op://Personal/Microsoft Client ID/notesPlainop://Personal/Microsoft Client Secret/notesPlain
本地文件: ~/.config/microsoft-skill/credentials.json 跑 pnpm tsx scripts/microsoft.ts setup 然后选择“手动输入”。
令牌存储
- 每个项目:
.claude/microsoft-skill.local.json - 全球:
~/.config/microsoft-skill/tokens.json
添加 .claude/*.local.* 到 .gitignore.
许可证
麻省理工学院
