List conversations
Conversations of your account with status, assignee, labels, priority and the last message.
MCP tool chatwoot_read → list_conversations
read
Returns one page of conversations, most recent activity first, with status, priority, inbox, channel, contact, assignee, labels, unread_count, last_message and last_activity_at. status picks the Chatwoot state: open, pending, resolved, snoozed or all. assignee is me, unassigned, assigned or all. query matches the text of messages. Pass page back for the next one and stop when has_more is false.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | open, pending, resolved, snoozed or all. Default: open. |
| assignee string | string | me, unassigned, assigned or all. Default: all. |
| inbox_id integer | integer | inbox_id from list_inboxes. |
| label string | string | Label name from list_labels. |
| contact_id integer | integer | contact_id from search_contacts, for the conversations of one contact. |
| query string | string | Text to find in the messages. |
| 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": "list_conversations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": 1842,
"status": "open",
"priority": null,
"inbox": "Support email",
"channel": "email",
"contact": {
"contact_id": 311,
"name": "Dana Whitfield"
},
"assignee": null,
"labels": [],
"unread_count": 2,
"last_message": {
"sender": "contact",
"content": "I was charged twice for October. Can you refund one payment?",
"created_at": "2026-10-22T06:41:00Z"
},
"last_activity_at": "2026-10-22T06:41:00Z"
},
{
"conversation_id": 1851,
"status": "open",
"priority": null,
"inbox": "Website chat",
"channel": "web_widget",
"contact": {
"contact_id": 327,
"name": "Priya Nair"
},
"assignee": null,
"labels": [],
"unread_count": 1,
"last_message": {
"sender": "contact",
"content": "I cannot find where to reset my password.",
"created_at": "2026-10-22T07:12:00Z"
},
"last_activity_at": "2026-10-22T07:12:00Z"
}
],
"page": 1,
"has_more": false
},
"isError": false
}