Mail Search
mail_searchFind messages in a mailbox folder, newest first: uid, sender, recipients, subject, date and whether it is unread. Filter by words (subject and body), sender, a start date and unread only; nothing is marked read. Pass a uid to mail_read.
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": "mail_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Sender address or part of it. | |
| limit | No | How many, 1–50 (default 20). | |
| query | No | Words to find in the subject or body. | |
| since | No | Only messages from this date on, YYYY-MM-DD. | |
| folder | No | Folder path from mail_folders (default INBOX). | |
| mailbox | No | The address of the mailbox to use (mail_accounts lists them); may be left out when only one is connected. | |
| unread_only | No | Only unread messages. |