mailroom_search
Search or list messages in a connected mailbox using Gmail query syntax, Microsoft 365 KQL, or IMAP filters, with folder, date, unread, and result-limit options.
Instructions
Search or list messages in a connected mailbox. Gmail accepts Gmail query syntax (from:x newer_than:7d has:attachment); Microsoft 365 accepts KQL; other IMAP servers accept from:, to:, subject: and free text.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "mailroom_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Messages to return (max 100, default 20). | |
| query | No | Search text. Leave empty to list the newest messages. | |
| since | No | Only messages after this ISO date, or a shorthand like 7d, 36h, 2w. | |
| folder | No | Folder: inbox (default), sent, drafts, trash, junk, archive, all, or a folder name. | |
| account | No | Which connected mailbox to use (its label from mailroom_accounts). Optional when only one is connected or a default is saved in memory. | |
| unread_only | No | Only unread messages (default false). |