Skip to main content
outlook_search_messages Full-text search across the user’s Outlook messages using KQL (Keyword Query Language) syntax. Searches subject, body, sender, and recipients. Returns message previews with IDs you can pass to outlook_get_message for the full content.

​
Parameters

​
Returns

An array of matching message objects with preview data, including id, subject, from, receivedDateTime, isRead, bodyPreview, and conversationId.
KQL supports phrases ("exact phrase"), field-scoped queries (from:user@domain.com, subject:keyword), and boolean operators (invoice AND 2024). For simple keyword searches, plain text works without any special syntax.

​
Example use

“Find all emails from alice@example.com with ‘budget’ in the subject.”