Outlook

通过您已连接 OOMOL 的账户操作 Outlook。该能力调用 outlook 连接器（通过 oo CLI）；OOMOL 在服务端注入凭据，因此您无需处理原始令牌。

类别：通信、生产力。共暴露 11 个操作（action）。

执行一个操作

假设用户已安装 oo CLI、完成登录并已连接 Outlook。请勿主动执行 oo auth login 或打开连接 URL —— 直接运行目标操作即可。仅当命令实际因身份验证或连接错误而失败时，才回退至“首次设置”流程。

1. 检查契约（contract）：在构造请求载荷前，先获取权威的输入/输出 Schema：

oo connector schema "outlook" --action ""

2. 执行操作：传入符合输入 Schema 的 JSON 载荷：

oo connector run "outlook" --action "" --data '' --json

• --data 接收一个 JSON 对象字符串，或以 @path/to/file.json 形式指定本地文件路径；若省略该参数，则默认发送空对象 {}。
• 响应格式为 { "data": ..., "meta": { "executionId": "..." } }；其中执行 ID 位于 meta.executionId 字段下。

下方每个操作均链接至一份参考文档，说明其用途及精确命令。请先阅读对应链接文档，再使用 oo connector schema 获取实时 Schema，最后构造 --data 参数内容。

可用操作

• create_draft — 创建一封新的 Outlook 草稿邮件，支持设置主题、正文、收件人及其他可写邮件属性。
• get_mailbox_settings — 获取当前 Outlook 邮箱设置，包括自动回复、区域设置（locale）、时区及工作时间等。
• get_message — 根据邮件 ID 获取单封 Outlook 邮件，包含邮件元数据及可选的正文格式化选项。
• get_profile — 从 Microsoft Graph 获取当前 Outlook 账户的个人资料，用于识别已连接的邮箱。
• list_mail_folders — 列出已连接邮箱的根级 Outlook 邮件文件夹，支持可选显示隐藏文件夹及字段筛选。
• list_messages — 列出邮箱或指定邮件文件夹中的 Outlook 邮件，支持 OData 过滤器、排序、字段选择与分页。
• reply_email — 回复一封现有 Outlook 邮件，可提供评论内容或完整替换正文，并可选择性添加额外收件人。
• send_draft — 根据邮件 ID 发送一封已存在的 Outlook 草稿邮件。
• send_email — 一次性发送一封全新的 Outlook 邮件，无需预先创建独立草稿。
• update_draft — 更新一封已存在的 Outlook 草稿邮件。可用于在发送前修改主题、正文、收件人或其他仅适用于草稿的属性。
• update_mailbox_settings — 更新 Outlook 邮箱设置，例如自动回复、区域设置（locale）、时区、工作时间以及日期/时间格式等。

安全性

• 读取类操作（get / list / search）可安全直接执行。
• 创建（create）、更新（update）、发送（send）或提交（post）类操作会改变 Outlook 状态 —— 执行前必须向用户确认载荷内容及其确切影响。
• 删除（delete）或移除（remove）类操作具有破坏性 —— 执行前必须明确确认目标对象，并获得用户的显式批准。

首次设置

以下为一次性步骤，切勿在每次调用时重复执行。仅当某条命令因对应原因失败时，才执行相应步骤。

• oo: command not found — 安装 oo CLI（其他平台安装指南：https://cli.oomol.com/install-guide.md）：

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• 未登录 / 身份验证错误 — 一次性登录您的 OOMOL 账户：

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Outlook 尚未连接，或连接已过期/缺少必要权限范围（scope）。请通过 OAuth2 认证方式，在以下地址完成一次连接：

  https://console.oomol.com/app-connections?provider=outlook
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — 账户余额不足导致服务暂停。请前往 https://console.oomol.com/billing/token-recharge 充值后重试。

相关资源

• Outlook 官网：https://www.microsoft.com/microsoft-365/outlook/email-and-calendar-software-microsoft-outlook