Emails
Email tools provide access to threads and messages synced from the team's shared inbox. Emails are automatically matched to known contacts during sync. Only emails involving recognized contacts are stored.
list_email_threads
List email threads, optionally filtered by contact or date.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| contact_id | string (UUID) | No | Filter to threads involving this contact |
| since | string | No | Only threads with messages since this date (YYYY-MM-DD) |
| limit | number | No | Max results (default: 25) |
| offset | number | No | Offset for pagination (default: 0) |
Example
json
{
"name": "list_email_threads",
"arguments": {
"contact_id": "550e8400-e29b-41d4-a716-446655440000",
"since": "2026-03-01"
}
}get_email_thread
Get a full email thread with all messages, linked contacts, and linked opportunities.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Yes | Email thread ID |
Example
json
{
"name": "get_email_thread",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}search_emails
Full-text search across email subjects and bodies.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Search query |
| limit | number | No | Max results (default: 20) |
Example
json
{
"name": "search_emails",
"arguments": {
"query": "product launch",
"limit": 10
}
}link_email_opportunity
Link an email thread to an opportunity.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| thread_id | string (UUID) | Yes | Email thread ID |
| opportunity_id | string (UUID) | Yes | Opportunity ID |
Example
json
{
"name": "link_email_opportunity",
"arguments": {
"thread_id": "550e8400-e29b-41d4-a716-446655440000",
"opportunity_id": "660e8400-e29b-41d4-a716-446655440000"
}
}unlink_email_opportunity
Remove an email-opportunity link.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Yes | email_opportunity record ID |
Example
json
{
"name": "unlink_email_opportunity",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}get_contact_emails
Get all email messages and threads involving a specific contact, ordered by most recent.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| contact_id | string (UUID) | Yes | Contact ID |
| limit | number | No | Max results (default: 25) |
Example
json
{
"name": "get_contact_emails",
"arguments": {
"contact_id": "550e8400-e29b-41d4-a716-446655440000",
"limit": 10
}
}get_email_sync_status
Check when the last email sync ran and how many emails are stored. Takes no parameters.
Parameters
None.
Example
json
{
"name": "get_email_sync_status",
"arguments": {}
}Response Shape
json
{
"last_sync_at": "2026-04-07T12:00:00Z",
"last_history_id": "...",
"total_messages_in_db": 1234
}