Skip to main content
Glama

list_conversations

Read-onlyIdempotent

List messaging conversations across WhatsApp, Messenger, Instagram, Threads, SMS, email, and other enabled channels. Threads items are public conversations. Shows unread counts and last message time.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNoPage number (default 1)
limitNoPage size (default 20, max 50)
searchNoSearch by contact name, phone, or email
statusNoFilter by conversation status
channelNoFilter by channel
assigneeNo"mine": conversations assigned to you. "unassigned": no assignee. Cannot be combined with assignedToId.
assignedToIdNoOnly conversations assigned to this company member ID (companyMembers.id)

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYesTool result payload — shape varies per tool, see the tool description
summaryYesOne-line human-readable summary of the action
renderTypeYesUI rendering hint for the result

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / properties / assignedToId
      Added value: +{
      +  "description": "Only conversations assigned to this company member ID (companyMembers.id)",
      +  "type": "string"
      +}
    • addedInput schema / properties / assignee
      Added value: +{
      +  "description": "\"mine\": conversations assigned to you. \"unassigned\": no assignee. Cannot be combined with assignedToId.",
      +  "enum": [
      +    "mine",
      +    "unassigned"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / limit / description
      Previous value: -"Max results (default 20)"New value: +"Page size (default 20, max 50)"
    • addedInput schema / properties / page
      Added value: +{
      +  "description": "Page number (default 1)",
      +  "type": "number"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.