search-emails
Search and filter emails in Outlook using queries, KQL, or specific criteria like sender, date, and attachments. Supports conversation threading, delta sync for updates, and message-ID lookups.
Instructions
Search and list emails. With no query, lists recent emails (like list-emails). Supports search queries, KQL, delta sync, message-id lookup, and conversation listing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deltaMode | No | Enable delta sync mode. Returns only changes since last sync. Use deltaToken for subsequent calls. | |
| internetMessageId | No | Look up email by Message-ID header (e.g. <abc123@example.com>). For threading/deduplication. | |
| conversationId | No | Get all messages in a conversation thread by conversationId. | |
| groupByConversation | No | List conversations (threads) grouped by conversationId instead of individual emails. | |
| query | No | Search query text. Omit for list mode. | |
| kqlQuery | No | Raw KQL (Keyword Query Language) query for advanced search. Bypasses other search params. | |
| folder | No | Email folder (default: 'inbox') | |
| from | No | Filter by sender email/name | |
| to | No | Filter by recipient email/name | |
| subject | No | Filter by subject | |
| hasAttachments | No | Filter to emails with attachments | |
| unreadOnly | No | Filter to unread emails only | |
| receivedAfter | No | Filter emails received after date (ISO 8601) | |
| receivedBefore | No | Filter emails received before date (ISO 8601) | |
| searchAllFolders | No | Search across all mail folders | |
| count | No | Number of results (list default: 25, search default: 10, max: 50) | |
| outputVerbosity | No | Output detail level (default: standard) | |
| deltaToken | No | Token from previous delta call for incremental sync (deltaMode only) | |
| maxResults | No | Max results per page for delta sync (default: 100, max: 200) | |
| includeHeaders | No | Include email headers for each message (conversationId only) |