List messages in a folder
list_messagesFetch message summaries from any Yahoo Mail folder, filtered by unread status, sender, subject text, or date to quickly locate relevant emails.
Instructions
List message summaries (subject, from, to, date, read status) in a given folder, optionally filtered by unread status, sender, subject text, or date.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"folder": "<folder>"
},
"name": "list_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Filter by sender address/name substring. | |
| limit | No | Max number of messages to return, newest first. Defaults to 20. | |
| since | No | Only return messages received on/after this ISO 8601 date. | |
| folder | Yes | Folder path to list messages from, e.g. 'INBOX'. | |
| subject | No | Filter by subject substring. | |
| unseenOnly | No | Only return unread messages. |