zoho_list_emails
List emails in a Zoho Mail folder or across folders, newest first. Filter by read status, flags, attachments, threads, and more to find messages quickly.
Instructions
List emails in a folder (or across folders if folderId is omitted), newest first by default. Returns summary, subject, sender, fromAddress, toAddress, messageId, folderId, threadId, receivedTime, status, flagid, hasAttachment.
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": "zoho_list_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of emails, 1-200 (default 10) | |
| start | No | 1-based starting sequence number (default 1) | |
| flagid | No | 0 not set, 1 info, 2 important, 3 follow-up | |
| sortBy | No | ||
| status | No | ||
| folderId | No | Folder ID (from zoho_list_folders). Pass as a string — Zoho IDs are 64-bit and lose precision as JSON numbers. | |
| threadId | No | Thread ID — list the emails of one conversation. Pass as a string — Zoho IDs are 64-bit and lose precision as JSON numbers. | |
| includeto | No | Include recipient details | |
| sortorder | No | true ascending, false descending (default) | |
| includesent | No | ||
| flaggedMails | No | Only flagged emails | |
| inlinedMails | No | Only emails with inline images | |
| attachedMails | No | Only emails with attachments | |
| threadedMails | No | Only emails that are part of a conversation | |
| includearchive | No | ||
| respondedMails | No | Only emails that have replies |