List conversations
Conversations of one mailbox by status, assignee or search text, with who wrote last.
MCP tool freescout_read → list_conversations
read
Returns conversations of one mailbox in the order FreeScout lists them, one page at a time; follow page while has_more is true. status defaults to active. last_reply_from says whether the customer or a teammate wrote last, and waiting_since is the time of the customer message nobody has answered. Deleted conversations are left out. Putting # in front of a number in query finds that conversation number.
Parameters
| Name | Type | Description |
|---|---|---|
| mailbox_id integer required | integer | Mailbox ID from list_mailboxes. It is the number at the end of the mailbox settings address. |
| status string | string | active, pending, closed or spam. Default active. |
| assigned_to string | string | A user_id from list_users, or unassigned. |
| query string | string | Search text. Use #12345 to find a conversation by its number. |
| page integer | integer | Page number, starting at 1. Follow it while has_more is true. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "freescout_read",
"arguments": {
"operation": "list_conversations",
"arguments": {
"mailbox_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": 4821,
"number": 1207,
"subject": "Invoice shows the wrong VAT number",
"customer": {
"name": "Lena Ortiz",
"email": "lena@example.com"
},
"status": "active",
"assignee": null,
"last_reply_from": "customer",
"waiting_since": "2026-10-21T14:05:00Z",
"preview": "Our invoice from October lists the wrong VAT number. Can you fix it?"
},
{
"conversation_id": 4833,
"number": 1219,
"subject": "Re: Invoice shows the wrong VAT number",
"customer": {
"name": "Lena Ortiz",
"email": "lena@example.com"
},
"status": "active",
"assignee": null,
"last_reply_from": "customer",
"waiting_since": "2026-10-22T09:40:00Z",
"preview": "Still no answer on my invoice. Who can help?"
}
],
"page": 1,
"has_more": false
},
"isError": false
}