All MCP tools
MCP tools · Chat inbox
list_chat_contacts
Lists the people who have chatted with the organization (WhatsApp, SMS, email, web chat and more): name, phone, email, labels and channel. Search by name, phone or email, or filter by label or channel.
- Scope needed
- chat:read or chat:write
- Changes data
- No, read only
- Held for approval
- No
- Available to
- Switched on per organization (MCP task tools)
Inputs
| Name | Type | Description |
|---|---|---|
| org_id | string | Organization id. Leave out when the user belongs to one organization; otherwise the error lists theirs. |
| q | string | Search text: a name, phone or email. |
| label | string | Only contacts with this label. |
| channel | enum: whatsapp | widget | sms | email | instagram | messenger | tiktok | Only this channel. widget is web chat. |
| cursor | string | next_cursor from the previous page. |