search_messages
Find mailbox messages newest first by full-text query, sender, recipient, subject, date range, folder, unread, or flagged filters; returns metadata for opening full message text.
Instructions
Find messages, newest first; with no filters, the latest ones.
query searches whole messages (headers and text) on the server. sender,
to and subject match those headers, and to also covers Cc; Greek text
there is matched without regard to case or accents, over the newest 3000
candidates. since and before are arrival dates (YYYY-MM-DD), before
exclusive. Each result has uid, date, from, to, subject, read/flag state and
whether it has attachments; use get_message for the 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": "search_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| limit | No | ||
| query | No | ||
| since | No | ||
| before | No | ||
| folder | No | inbox | |
| sender | No | ||
| subject | No | ||
| unread_only | No | ||
| flagged_only | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |