search-emails
Read-only
Search and list emails using queries, KQL, or filters like sender, subject, folder, and date. Also supports delta sync and conversation threading.
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) |