邮件管理插件

一个用于Microsoft Graph API集成的Claude Code插件,专注于Outlook/Hotmail电子邮件访问。

  • by The-Focus-AI
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 The-Focus-AI/microsoft-skill

使用说明

微软技能

用于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邮件”

首次设置

  1. 配置凭据:

    pnpm tsx skills/microsoft-outlook/scripts/microsoft.ts setup
    
  2. 验证:

    pnpm tsx skills/microsoft-outlook/scripts/microsoft.ts auth
    
  3. 验证:

    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 <id> 将邮件下载为.eml
download-all 下载最近的消息

凭证设置

在中注册应用程序 微软Entra管理中心 或 Azure 门户:

  1. 登录:使用您的Microsoft帐户。如果您看到不在目录中的错误,请按照提示“注册Azure”(免费)创建默认目录。
  2. 应用程序注册 > 新注册
  3. 名字: microsoft-skill-cli
  4. 支持的帐户类型:选择 任何组织目录中的帐户(任何Microsoft Entra ID租户-多租户)和个人Microsoft帐户(例如Skype、Xbox).
    • 注意:如果您想使用个人@outlook.com或@hotmail.com帐户,这是必需的。
  5. 重定向URI:选择 网络 并进入 http://localhost:3000/callback.
  6. 注册:单击按钮。
  7. 客户端ID:复制 应用程序(客户端)ID 从概述页面。
  8. 客户端密钥:
    • 首选 证书和秘密 > 新客户机密.
    • 添加描述并单击 添加.
    • 复制 价值 (不是秘密ID)立即。
  9. API权限:
    • 首选 API权限 > 添加权限.
    • 选择 微软图形 > 委托权限.
    • 添加 Mail.Read 和 User.Read.
    • (可选)单击 授予管理员同意 如果你是租户管理员。

存储选项

1密码 (推荐): 该脚本在您的 个人 拱顶:

  • op://Personal/Microsoft Client ID/notesPlain
  • op://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.

许可证

麻省理工学院