list_emails
Retrieve email messages from any folder with filters for unread, recipient domain, query, or time range.
Instructions
List messages in a folder.
Args:
account: Account label (use list_email_accounts to see options). If
omitted, the first configured account is used.
folder: Folder (IMAP) or label (Gmail). Default INBOX.
limit: Max number of messages to return. Default 25.
query: Free-text search. For Gmail, pass native Gmail operators
(e.g. from:@example.com). For IMAP this becomes a TEXT search.
unread_only: If true, only return unread messages.
recipients: Filter to messages delivered to (or Cc'd / Bcc'd to) any
of these addresses OR domains. Each entry may be a full address
(sean@nasource.com) or a bare domain (nasource.com). Use this
to answer questions like "who emails me at my alias domains?" —
pass e.g. ["nasource.com", "seankendall.com"]. OR-combined.
since_days: Only return messages newer than this many days. STRONGLY
recommended when using recipients on a large mailbox — a full-
mailbox recipient search can take minutes on accounts with tens
of thousands of messages. For "last 30 days" questions pass 30.
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": "list_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | ||
| folder | No | INBOX | |
| limit | No | ||
| query | No | ||
| unread_only | No | ||
| recipients | No | ||
| since_days | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |