Get conversation messages
The message thread of a conversation, oldest first, with channel and direction.
MCP tool kustomer_read → get_conversation_messages
read
Returns the messages and internal notes of one conversation in chronological order. Each message says whether it is inbound or outbound, the channel (email, chat, SMS and so on) and who wrote it. Filter by channel or direction. Pass next_cursor back as cursor for the next page of a long thread.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id string required | string | Conversation ID from search_conversations. |
| direction enum | enum | in or out. Default: both. |
| channel string | string | Only messages on this channel, e.g. email or sms. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kustomer_read",
"arguments": {
"operation": "get_conversation_messages",
"arguments": {
"conversation_id": "conversation_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"messages": [
{
"message_id": "6718d2e4a1b2c3d4e5f60801",
"direction": "in",
"channel": "email",
"author": "Dana Whitfield",
"body": "Export to CSV fails every time.",
"created_at": "2026-10-10T08:55:00Z"
},
{
"message_id": "6718d2e4a1b2c3d4e5f60802",
"direction": "out",
"channel": "email",
"author": "Sam Okafor",
"body": "Sorry about that. Can you send the order number from your confirmation email?",
"created_at": "2026-10-11T09:30:00Z"
}
],
"next_cursor": null
},
"isError": false
}