Search Emails
search_emailsSearch logged emails by date, user, or contact. Returns complete email data (sender, recipients, subject, body) and offers count-only mode for accurate totals on large datasets.
Instructions
Search for logged emails with optional filters. Use this to find emails by date range, user, or contact.
RETURNS FULL DATA: Each result includes all email fields (sender, recipients, subject, body, timestamps, etc.) - no need to call get_email afterward.
Use count_only=true for accurate counts on large datasets without returning the full result set.
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 |
|---|---|---|---|
| page | No | Page number for pagination | |
| date_end | No | Return emails before this date (ISO 8601) | |
| contact_id | No | Filter by contact ID | |
| count_only | No | When true, auto-paginates and returns only total count and breakdowns (no results array). Use for accurate counts on large datasets. | |
| date_start | No | Return emails after this date (ISO 8601) | |
| max_results | No | Max results (default 500, max 10000) | |
| user_filter | No | Filter by user IDs | |
| sort_direction | No | ||
| include_company_contacts | No | Include emails from contacts at same company |