list_emails_metadata
Retrieve email metadata (subject, sender, recipients, date) with filters like sender, recipient, date range, read status, and attachments. Use returned email IDs to fetch full content.
Instructions
List email metadata (email_id, subject, sender, recipients, date) without body content. Returns email_id for use with get_emails_content.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Search for text in the email body (IMAP BODY). | |
| page | No | The page number to retrieve (starting from 1). | |
| seen | No | Filter by read status: True=read, False=unread, None=all. | |
| text | No | Search for text in the entire message — headers and body (IMAP TEXT). | |
| order | No | Order emails by field. `asc` or `desc`. | desc |
| since | No | Retrieve emails since this datetime (UTC). | |
| before | No | Retrieve emails before this datetime (UTC). | |
| flagged | No | Filter by flagged/starred status: True=flagged, False=unflagged, None=all. | |
| mailbox | No | The mailbox to search. | INBOX |
| subject | No | Filter emails by subject. | |
| answered | No | Filter by replied status: True=replied, False=not replied, None=all. | |
| page_size | No | The number of emails to retrieve per page. | |
| to_address | No | Filter emails by recipient address. | |
| account_name | Yes | The name of the email account. | |
| from_address | No | Filter emails by sender address. | |
| has_attachment | No | Filter by attachment presence: True=has attachment, False=none, None=all (multipart/mixed heuristic; may miss inline images or yield false positives). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| since | Yes | ||
| total | Yes | ||
| before | Yes | ||
| emails | Yes | ||
| subject | Yes | ||
| page_size | Yes |