> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook search

> Search the user's Outlook / Microsoft 365 mailbox via Microsoft Graph. Returns message headers + snippets (not full bodies — follow up with…

`outlook_search`

Search the user's Outlook / Microsoft 365 mailbox via Microsoft Graph. Returns message headers + snippets (not full bodies — follow up with `outlook_get_message`). Two modes:   - `search` (free-text, KQL-like): `subject:invoice`, `from:sarah@example.com`, `hasattachment:yes`, `received:2026-01-01..2026-01-31`. Combine with spaces.   - `filter` (OData, precise): `from/emailAddress/address eq 'sarah@example.com'`, `receivedDateTime ge 2026-01-01T00:00:00Z`, `hasAttachments eq true`. Combine with `and`/`or`. Prefer `search` for natural-language queries; use `filter` when you need exact field matching or date ranges. Leave both empty for most-recent messages.

## Parameters

<ParamField path="search" type="string">
  KQL-like free-text search. e.g. `subject:invoice from:sarah@example.com`. Mutually exclusive with `filter`.
</ParamField>

<ParamField path="filter" type="string">
  OData filter expression. e.g. `from/emailAddress/address eq 'sarah@example.com' and hasAttachments eq true`.
</ParamField>

<ParamField path="limit" type="integer" default={15}>
  Minimum: 1. Maximum: 50.
</ParamField>