List conversations
Conversations in the Inbox with the last message of each.
MCP tool simpletexting_read → list_conversations
read
Reads the Inbox as it shows it: one row per contact with the last message, its direction (incoming or outgoing) and who the conversation is assigned to. Replies to campaigns are included, because SimpleTexting delivers them to the Inbox. Filter by a search on the contact or by assignee. Page with next_cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Contact name or phone number. |
| assigned_to string | string | Name of a team member. Leave out for all conversations. |
| 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": "simpletexting_read",
"arguments": {
"operation": "list_conversations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": "c_8f21a6",
"contact": {
"name": "Dana Whitfield",
"phone": "+12125550147"
},
"last_message": {
"direction": "incoming",
"text": "Can I move my cleaning to Friday?",
"at": "2026-10-23T09:12:00-04:00"
},
"assigned_to": null
},
{
"conversation_id": "c_5b09d3",
"contact": {
"name": "Marcus Lee",
"phone": "+12125550163"
},
"last_message": {
"direction": "outgoing",
"text": "See you at 3 pm.",
"at": "2026-10-22T16:40:00-04:00"
},
"assigned_to": "Priya Nair"
}
],
"next_cursor": null
},
"isError": false
}