Microsoft 365 Integration

# Microsoft 365 Integration

## 描述

通过 Microsoft Graph API 访问 Microsoft 365 服务 - 邮件、日历、OneDrive、待办事项和联系人。

## 激活

当用户提及以下内容时激活：outlook, email, calendar, onedrive, microsoft, office 365, o365, ms365, my meetings, my emails, schedule meeting, send email, check calendar, to do, microsoft tasks

## 配置

首次登录后会缓存身份验证信息。设备代码流不需要环境变量。

对于无头/自动化操作，请设置以下环境变量： - MS365_MCP_CLIENT_ID - Azure AD 应用程序客户端 ID - MS365_MCP_CLIENT_SECRET - Azure AD 应用程序密钥 - MS365_MCP_TENANT_ID - 租户 ID（个人帐户使用 "consumers"）

## 可用命令

### 身份验证

```bash # Login via device code (interactive) python3 /root/clawd/skills/ms365/ms365_cli.py login

# Check authentication status python3 /root/clawd/skills/ms365/ms365_cli.py status

# List cached accounts python3 /root/clawd/skills/ms365/ms365_cli.py accounts

# Get current user info python3 /root/clawd/skills/ms365/ms365_cli.py user ```

### 电子邮件

```bash # List recent emails python3 /root/clawd/skills/ms365/ms365_cli.py mail list [--top N]

# Read specific email python3 /root/clawd/skills/ms365/ms365_cli.py mail read MESSAGE_ID

# Send email python3 /root/clawd/skills/ms365/ms365_cli.py mail send --to "[email protected]" --subject "Subject" --body "Message body" ```

### 日历

```bash # List upcoming events python3 /root/clawd/skills/ms365/ms365_cli.py calendar list [--top N]

# Create event python3 /root/clawd/skills/ms365/ms365_cli.py calendar create --subject "Meeting" --start "2026-01-15T10:00:00" --end "2026-01-15T11:00:00" [--body "Description"] [--timezone "America/Chicago"] ```

### OneDrive 文件

```bash # List files in root python3 /root/clawd/skills/ms365/ms365_cli.py files list

# List files in folder python3 /root/clawd/skills/ms365/ms365_cli.py files list --path "Documents" ```

### 待办事项任务

```bash # List task lists python3 /root/clawd/skills/ms365/ms365_cli.py tasks lists

# Get tasks from a list python3 /root/clawd/skills/ms365/ms365_cli.py tasks get LIST_ID

# Create task python3 /root/clawd/skills/ms365/ms365_cli.py tasks create LIST_ID --title "Task title" [--due "2026-01-20"] ```

### 联系人

```bash # List contacts python3 /root/clawd/skills/ms365/ms365_cli.py contacts list [--top N]

# Search contacts python3 /root/clawd/skills/ms365/ms365_cli.py contacts search "John" ```

## 使用示例

用户：“查看我的 outlook 邮件” Agent：运行 `mail list --top 10` 命令

用户：“我今天有哪些会议？” Agent：运行 `calendar list` 命令

用户：“给 [email protected] 发一封关于项目更新的邮件” Agent：使用适当的参数运行 `mail send`

用户：“显示我的 OneDrive 文件” Agent：运行 `files list` 命令

用户：“添加一个审查预算的任务” Agent：首先列出任务列表，然后在适当的列表中创建任务

## 提示

在协助处理 Microsoft 365 时： - 所有操作都使用 ms365_cli.py 脚本 - 如果命令失败，请首先检查身份验证状态 - 如果未登录，引导用户完成设备代码登录流程 - 对于日历事件，使用 ISO 8601 日期时间格式 - 默认时区为 America/Chicago - 发送邮件时，请在发送前确认收件人和内容 - 对于任务，请先列出可用的任务列表，以便用户进行选择

## 归属

此技能使用 Softeria 开发的 **ms-365-mcp-server**。 - **NPM 包**：[@softeria/ms-365-mcp-server](https://www.npmjs.com/package/@softeria/ms-365-mcp-server) - **GitHub**：https://github.com/Softeria/ms-365-mcp-server - **许可证**：MIT