---
title: "List Users"
description: "List the users (members) in the workspace/company, with their ids, names, emails, and permissions."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List Users

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](/mcp/tools/users-team/) lists the rest of the Users & teams
  category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/users-team/list_users/index.mdx