List conversations
Conversations in your inbox: calls and SMS threads, newest activity first.
MCP tool aircall_read → list_conversations
read
Lists the Conversations tab of the Aircall Inbox, where calls and messages of one contact sit together. Each row has the contact or number, the line, the last activity, the type of the last item and a short preview of a message. Search by name or number. Page with next_cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Contact name or phone number. |
| limit integer | integer | Page size. |
| cursor string | string | next_cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "aircall_read",
"arguments": {
"operation": "list_conversations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": "conv_5521",
"contact": {
"name": "Priya Raman",
"number": "+14155550142"
},
"line": "Sales US",
"last_item": "call",
"last_activity_at": "2026-10-22T16:41:08Z",
"preview": null
}
],
"next_cursor": null
},
"isError": false
}