Search contacts
Find contacts by a search term, with their email, phone and number of conversations.
MCP tool chatwoot_read → search_contacts
read
Returns the contacts that match the term, with contact_id, name, email, phone and conversation count. Use contact_id as the contact_id of list_conversations to read their history. Chatwoot lists only resolved contacts, the ones with an identifier, an email or a phone number.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Text to search for, for example an email address. |
| page integer | integer | Page number, from 1. Default: 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "chatwoot_read",
"arguments": {
"operation": "search_contacts",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"contacts": [
{
"contact_id": 327,
"name": "Priya Nair",
"email": "priya@example.com",
"phone": null,
"conversations": 3
}
],
"page": 1,
"has_more": false
},
"isError": false
}