Microsoft 365 集成

描述

通过 MS Graph API 访问 Microsoft 365 服务 - 电子邮件 (Outlook)、日历、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"）

可用命令

身份验证

# 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

电子邮件 (Outlook)

# 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 "recipient@example.com" --subject "Subject" --body "Message body"

日历

# 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 文件

# 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"

待办任务

# 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"]

联系人

# 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邮件" 代理：运行邮件列表 --前十条命令

用户："我今天有哪些会议？" 代理：运行日历列表命令

用户："发送一封邮件给john@company.com关于项目更新" 代理：运行邮件发送使用适当的参数

用户："显示我的OneDrive文件" 代理：运行文件列表命令

用户："添加一个审查预算的任务" 代理：首先列出任务列表，然后在合适的列表中创建任务

提示

当协助处理Microsoft 365时：

• 所有操作都使用ms365_cli.py脚本
• 如果命令失败，首先检查认证状态
• 如果未登录，引导用户通过设备代码登录
• 对于日历事件，使用ISO 8601日期时间格式
• 默认时区为America/Chicago
• 发送电子邮件前，请确认收件人和内容
• 对于任务，请先列出可用的任务列表供用户选择

归属声明

此技能使用了ms-365-mcp-server由Softeria提供。

• NPM包：@softeria/ms-365-mcp-server
• GitHub：https://github.com/Softeria/ms-365-mcp-server
• 许可证：MIT