Use the Speak AI MCP server tool list_users to list the users (members) in the
workspace/company, with their ids, names, emails, and permissions.
What does it do?
List the users (members) in the workspace/company, with their ids, names, emails, and permissions. Use the returned _id values when assigning members to user groups.
Parameters
list_users takes 4 parameters, all of them optional.
| Name | Type | Required | Description |
|---|---|---|---|
filterName |
string | No | Search text. Plain text matches first/last name or email; prefix with “email:” or “name:” to scope, e.g. “email:jane@acme.com”. |
sortBy |
string | No | Sort expression “field:asc” or “field:desc”, e.g. “createdAt:desc”, “email:asc” |
page |
number | No | 0-based page index (default 0) |
pageSize |
number | No | Results per page (default 50) |
Behaviour
The Speak AI MCP server publishes these behaviour hints for list_users.
- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.
Related
- Users & teams lists the rest of the Users & teams category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.