List conversations
Your Otter conversations, most recent first, with title, owner, date and summary.
MCP tool otter_read → list_conversations
read
Lists conversations you own, most recent first, the same order as My Conversations. Set include_shared to add conversations shared with you, or pass channel_id to list one Channel, which includes shared ones. The summary is Otter's generated summary and is empty while processing is still running. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| include_shared boolean | boolean | Also list conversations shared with you. Default: false. |
| channel_id string | string | Only conversations in this Channel, from list_channels. |
| limit integer | integer | Page size. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "otter_read",
"arguments": {
"operation": "list_conversations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": "cv_7f3a91",
"title": "Pricing review with Acme",
"owner": "you@example.com",
"created_at": "2026-10-13T14:00:00Z",
"summary": "The team compared per-seat and flat-rate pricing and agreed to send a revised quote.",
"shared": true
},
{
"conversation_id": "cv_2b84d0",
"title": "Onboarding kickoff",
"owner": "you@example.com",
"created_at": "2026-10-14T09:30:00Z",
"summary": null,
"shared": false
}
],
"next_cursor": "eyJvZmZzZXQiOjIwfQ"
},
"isError": false
}