search_emails
Search a mailbox for emails by text, sender, recipient, subject, date, unseen/flagged status, attachment, or size; results are newest first and paginate for follow-up actions.
Instructions
Search a mailbox for emails (newest first); filters for text, from_, to, subject, date (since/before, YYYY-MM-DD), unseen/flagged, attachment and size. all_mail=True searches all folders ('All Mail'); limit/offset paginate.
The uid in the result is used by get_email/mark_email/move_email/
delete_email (valid in the chosen folder, with all_mail in 'All Mail');
'*' marks unread. Bridge does not search non-ASCII terms (e.g. 'café') -
this server filters them client-side against decoded headers/bodies.
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": "search_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| text | No | ||
| from_ | No | ||
| limit | No | ||
| since | No | ||
| before | No | ||
| folder | No | INBOX | |
| offset | No | ||
| subject | No | ||
| all_mail | No | ||
| unseen_only | No | ||
| flagged_only | No | ||
| has_attachment | No | ||
| larger_than_kb | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |