find_user_by_name
Locate a user in ClickUp by their name or email address to streamline task assignments and team management. Works with or without a specified workspace ID for efficient searching.
Instructions
Find a user by name or email
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name or email to search for | |
| workspace_id | No | Workspace ID (optional, uses default if not provided) |
Implementation Reference
- src/clickup_mcp/tools.py:1385-1419 (handler)The main handler function that executes the 'find_user_by_name' tool. It fetches workspace members using the ClickUp client and performs a case-insensitive search by name or email, returning matching users.async def find_user_by_name( self, name: str, workspace_id: Optional[str] = None ) -> Dict[str, Any]: """Find a user by name or email.""" members = await self.client.get_workspace_members(workspace_id) # Search by username or email (case-insensitive) name_lower = name.lower() matches = [] for member in members: username = member.get("username", "").lower() email = member.get("email", "").lower() if name_lower in username or name_lower in email: matches.append( { "id": member.get("id"), "username": member.get("username"), "email": member.get("email"), "initials": member.get("initials"), "color": member.get("color"), "profilePicture": member.get("profilePicture"), } ) if not matches: return {"error": f"No user found matching '{name}'", "matches": []} return { "matches": matches, "count": len(matches), "found": True, }
- src/clickup_mcp/tools.py:490-507 (schema)The input schema definition for the 'find_user_by_name' tool, specifying required 'name' parameter and optional 'workspace_id'.Tool( name="find_user_by_name", description="Find a user by name or email", inputSchema={ "type": "object", "properties": { "name": { "type": "string", "description": "Name or email to search for", }, "workspace_id": { "type": "string", "description": "Workspace ID (optional, uses default if not provided)", }, }, "required": ["name"], }, ),
- src/clickup_mcp/tools.py:56-57 (registration)Maps the tool name 'find_user_by_name' to its handler method in the internal _tools dictionary, used by call_tool."find_user_by_name": self.find_user_by_name, }