list_users
Retrieve all workspace members to manage team access and assign tasks in ClickUp project workflows.
Instructions
List all users in the workspace
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace_id | No | Workspace ID (optional, uses default if not provided) |
Implementation Reference
- src/clickup_mcp/tools.py:1352-1369 (handler)The core execution logic for the 'list_users' tool. Fetches workspace members from ClickUp API via client and returns formatted list.
async def list_users(self, workspace_id: Optional[str] = None) -> Dict[str, Any]: """List all users in the workspace.""" members = await self.client.get_workspace_members(workspace_id) return { "users": [ { "id": member.get("id"), "username": member.get("username"), "email": member.get("email"), "initials": member.get("initials"), "color": member.get("color"), "profilePicture": member.get("profilePicture"), } for member in members ], "count": len(members), } - src/clickup_mcp/tools.py:469-481 (schema)MCP Tool schema definition for 'list_users', specifying input parameters and description.
Tool( name="list_users", description="List all users in the workspace", inputSchema={ "type": "object", "properties": { "workspace_id": { "type": "string", "description": "Workspace ID (optional, uses default if not provided)", }, }, }, ), - src/clickup_mcp/tools.py:53-58 (registration)Registers the list_users method in the ClickUpTools class's internal tools dictionary for dynamic dispatching.
# User management "list_users": self.list_users, "get_current_user": self.get_current_user, "find_user_by_name": self.find_user_by_name, }