find_emails
Search and filter synced emails by keyword, folder, contact, unread or starred status, and date range. Returns matching emails with sender, subject, date, and snippet.
Instructions
Search or list the user's synced email. Pass a query to full-text search subject + body across the whole mailbox, and/or filter by folder, contactId (email from/to that contact), unreadOnly, starredOnly, or a date window (dateFrom/dateTo). Returns matching emails with their ids, sender, subject, date, folder, read/starred flags, and a snippet. This is the tool for 'did X email me', 'what's unread in my inbox', 'show me emails from this client', or 'find that email about the inspection'. Get an emailId here before get_email / update_email / delete_email.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 15, max 50). | |
| query | No | Keyword to match in subject or body. Optional when filtering by folder/contact/flags/date. | |
| dateTo | No | ISO 8601 date — only emails on or before this. | |
| folder | No | Restrict to one folder (inbox, sent, archive, trash, draft). | |
| dateFrom | No | ISO 8601 date — only emails on or after this. | |
| contactId | No | Only emails linked to this contact (from find_contacts). | |
| unreadOnly | No | Only unread emails. | |
| starredOnly | No | Only starred emails. |