list_team_members
List collaborators on a team. Owner pseudo-row is prepended; role_id is null for the owner.
List the collaborators on a team — the owner pseudo-row is prepended to every pivot member. role_id is null for the owner. Emails are surfaced verbatim because team members are internal collaborators, not subscribers.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
team_id*stringUUID of the team whose members to list.
What it returns
{ "data": [ { "id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Priya Patel", "email": "priya@example.com", "role_id": null, "is_owner": true, "joined_at": "2026-04-02T14:15:00Z" } ], "meta": { "total": 3 }}How it fails
RESOURCE_NOT_FOUNDteam_id is not a valid UUID, or the team falls outside the caller's visibility set.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks team-member:view-any.
How is this guide?
Last updated on