m365_search_emails

Microsoft 365 · macOS · Windows

效果: 读取. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

当用户想通过云端在其 Microsoft 365 / Outlook 邮箱中查找电子邮件时使用此工具；需要已连接的 M365 账户。默认搜索发件人、主题和正文（Microsoft Graph 自身的 $search 默认行为）。传入 scope="metadata" 可只搜索发件人/主题（速度更快，不扫描正文），传入 scope="body" 可只搜索消息正文。对于已添加到 Mac 的 Mail.app 的账户，请使用 search_emails。

必填输入

query

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — macOS

{
  "properties": {
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "integer"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:[email protected]', 'subject:invoice'",
      "type": "string"
    },
    "scope": {
      "description": "\"all\" (default — sender+subject+body, today's behavior), \"metadata\" (sender+subject only), or \"body\" (body only).",
      "enum": [
        "metadata",
        "body",
        "all"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

文档示例

m365_search_emails 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{
  "query": "launch checklist"
}

Windows

用途

在你的 Microsoft 365 电子邮件中按关键字、发件人或主题搜索。