MCP Tools: Users
All calls: POST /api/mcp with {"method":"tools/call","params":{"name":"<tool>","arguments":{…}}}.
list_users
Lists all users in the organization. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
status | enum active | inactive | suspended | – | Filter by status |
role | enum admin | user | guest | – | Filter by role |
teamId | string | – | Filter by team membership |
search | string | – | Search in name and email |
limit | number | 50 | Number of results |
offset | number | 0 | Skip results |
Response: { users, total, limit, offset, has_more }.
get_user
Details of a single user. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
userId | string (required) | – | UUID of the user |
get_me
The currently authenticated user. read · guest
No parameters.
get_user_workload
Workload: open assigned tasks by status — only in projects the caller can access. read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
userId | string | current user | Which user to query |
Response: { user, workload: { open_tasks, overdue, by_status[], completed_last_7_days } }.
invite_user
Invites one or more people into the current organization by email and sends each an invitation mail with a join link.
write · admin| Parameter | Type | Default | Description |
|---|---|---|---|
emails | string[] (1–20) (required) | – | Email addresses |
role | enum user | guest | user | user = full member, guest = follows only the projects in lists |
lists | string[] | – | Only for guest, required there: IDs or SIDs of the projects the guest follows |
Only admins/owners may invite members. Guests may also be invited by the owner of all given projects. Guests require the Pro plan. All of this is enforced server-side. The response contains a result per email (invited / already a member / already invited).
What a guest can do is described under Teams & Workspace → Guests.
Confirm first
Agree the addresses, the role and, for guests, the projects with the user before calling — an invitation cannot be taken back.