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 (assigned items by status). read · follower
| Parameter | Type | Default | Description |
|---|---|---|---|
userId | string | current user | Which user to query |
Response: { total_cards, total_overdue, by_status[] }.
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 = limited |
Only admins/owners may invite — this is enforced server-side. The response contains a result per email (invited / already a member / already invited).
Confirm first
Agree the addresses and the role with the user before calling — an invitation cannot be taken back.