# List Conversations

`quo_list-conversations` · Quo MCP tool · Conversations

List conversations on the connected Quo account. Supports pagination via maxResults (1-100, required) and pageToken, plus optional filters: phoneNumber, phoneNumbers, userId, createdAfter/createdBefore, updatedAfter/updatedBefore, and excludeInactive.

## Quo Frequently Asked Questions

**What does the List Conversations tool do?**

This page documents the List Conversations tool (`quo_list-conversations`). List conversations on the connected Quo account. Supports pagination via maxResults (1-100, required) and pageToken, plus optional filters: phoneNumber, phoneNumbers, userId, createdAfter/createdBefore, updatedAfter/updatedBefore, and excludeInactive. It is one of the Quo Conversations tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

**What is the Quo integration?**

The Quo integration connects your firm's Quo account to Weave. Quo is a cloud phone/SMS platform. This integration exposes calls, messages, contacts, conversations, and tasks as governed MCP tools, scoped per member by access level. It groups 36 tools into 6 categories, exposed through your firm's Weave MCP connection and filtered per member by access level.

**How does my firm connect Quo to Weave?**

An admin connects Quo once for the whole firm by entering your Quo workspace API key in the Weave console. Every member then works through that single connection; there is no per-user Quo login. Your key is encrypted at rest and stays inside Weave's infrastructure.

**Do I need to install or configure anything locally?**

No. Weave is fully hosted, so there is nothing to install, run, or maintain on your own machines. After an admin connects Quo once from the console, each member simply points their AI assistant at your firm's Weave MCP endpoint, and the tools they are allowed to use appear automatically based on their access level.

**Can everyone on my team use every tool?**

No. Tools are exposed per member by access level, so each person only sees the Quo tools their role permits.

**Are changes made through these tools reversible?**

Reads are always safe. Sending a text cannot be undone, once sent it can't be recalled, and it spends the workspace's prepaid SMS credits. Deletes are irreversible: delete-contact and delete-task permanently remove the record from Quo. Most other actions can be reversed with a follow-up tool (for example reopen-task or unassign-task).

**Why can't I send a text to a US number?**

Sending SMS to US numbers requires your Quo account to have completed US Carrier Registration. That is a Quo-side prerequisite; once it is done, send-message works for US recipients.

## Related
- /integrations/quo/messages/list-messages/
- /integrations/quo/calls/list-calls/
- /integrations/quo/tasks/link-task-conversation/

## Input

- **maxResults** `integer` (required, >= 1, <= 100) — Max conversations to return per page (1-100).
- **pageToken** `string` — Opaque pagination token from a prior response's nextPageToken, to fetch the next page.
- **phoneNumber** `string` (min length: 1) — Filter to conversations on this single E.164 phone number.
- **phoneNumbers** `array` — Filter to conversations on any of these E.164 phone numbers (forwarded as repeated query keys).
  - **[]** `string` (min length: 1)
- **userId** `string` (min length: 1) — Filter to conversations assigned to this user id.
- **createdAfter** `string(date-time)` (pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$) — Filter to conversations created at or after this ISO 8601 timestamp.
- **createdBefore** `string(date-time)` (pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$) — Filter to conversations created at or before this ISO 8601 timestamp.
- **updatedAfter** `string(date-time)` (pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$) — Filter to conversations last updated at or after this ISO 8601 timestamp.
- **updatedBefore** `string(date-time)` (pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$) — Filter to conversations last updated at or before this ISO 8601 timestamp.
- **excludeInactive** `boolean` — When true, exclude inactive (e.g. deleted) conversations from the results.

## Output

- **data** `array` (required) — The page of conversations returned.
  - **[]** `object`
    - **assignedTo** `string | null` (required) — Id of the user assigned to this conversation, or null if unassigned.
    - **createdAt** `string | null` (required) — ISO 8601 timestamp the conversation was created, or null.
    - **deletedAt** `string | null` (required) — ISO 8601 timestamp the conversation was deleted, or null if not deleted.
    - **id** `string` (required) — Internal identifier of the conversation.
    - **lastActivityAt** `string | null` (required) — ISO 8601 timestamp of the conversation's most recent activity, or null.
    - **lastActivityId** `string | null` (required) — Internal identifier of the conversation's last activity, or null.
    - **mutedUntil** `string | null` (required) — ISO 8601 timestamp the conversation is muted until, or null if not muted.
    - **name** `string | null` (required) — The conversation's display name, or null if unset.
    - **participants** `array` (required) — E.164 phone numbers of the conversation's participants.
      - **[]** `string`
    - **phoneNumberId** `string` (required) — Internal identifier of the Quo phone number this conversation belongs to.
    - **snoozedUntil** `string | null` (required) — ISO 8601 timestamp the conversation is snoozed until, or null if not snoozed.
    - **updatedAt** `string | null` (required) — ISO 8601 timestamp the conversation was last updated, or null.
- **totalItems** `integer` (required) — Total conversation count across all pages, as reported by Quo. Quo documents this figure may be inaccurate.
- **nextPageToken** `string | null` (required) — Opaque token for the next page, or null when there is no further page.