m365_search_emails

Microsoft 365 · macOS · Windows

効果: 読み取り. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

ユーザーが Microsoft 365 / Outlook のメールボックスからクラウド経由でメールを検索したいときに使います。接続済みの M365 アカウントが必要です。既定では、送信者、件名、本文のすべてを検索します（Microsoft Graph 自身の $search の既定動作）。scope="metadata" を渡すと送信者/件名だけを検索し（本文をスキャンしないので高速）、scope="body" を渡すと本文だけを検索します。folder を渡すと 1 つのフォルダを検索します（既知の名前、または m365_list_email_folders で得た id、名前、パス）。Mac の Mail.app に追加されているアカウントには、search_emails を使ってください。

必須入力

query

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "folder": {
      "description": "Search only this folder: a well-known name, or an id, name or path from m365_list_email_folders. Leave it out to search the whole mailbox.",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "integer"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:alice@contoso.com', '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 のメールをキーワード、送信者、件名で検索します。folder を渡すと 1 つのフォルダを検索します（既知の名前、または m365_list_email_folders で得た id、名前、パス）。

必須入力

query

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — Windows

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "folder": {
      "description": "Search only this folder: a well-known name, or an id, name or path from m365_list_email_folders. Leave it out to search the whole mailbox.",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "number"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:alice@contoso.com', 'subject:invoice'",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

ドキュメント例

{
  "query": "launch checklist"
}