gitlab_get_user_details
Retrieve detailed GitLab user activity summaries and contributions for performance reviews, team analysis, and collaboration context.
Instructions
Get comprehensive activity summary and contributions for a specific user.
Returns detailed information about a user's GitLab activity including recent contributions, project involvement, and activity statistics. Use this tool when you need detailed insights into a user's GitLab activity and contributions.
Examples:
Performance reviews: get_user_details(user_id=123)
Team member activity overview
Contributor analysis for projects
For basic user profile info, use 'gitlab_get_user' instead. For finding users by search, use 'gitlab_search_user' instead.
Returns extended user information:
Profile: name, bio, location, company
Statistics: public projects, contribution stats
Activity: last sign-in, creation date
Settings: timezone, preferred language
Social: website, LinkedIn, Twitter links
Use cases:
Review team member profiles
Gather user context for collaboration
Audit user activity and contributions
Display rich user information in tools
Parameters:
user_id: Numeric user ID
username: Username string (use either user_id or username)
Example: Get user details by username
{
"username": "johndoe"
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | No | Numeric user ID | |
| username | No | Username string |
Implementation Reference
- src/mcp_gitlab/tool_handlers.py:669-675 (handler)The main handler function for 'gitlab_get_user_details' that extracts user_id or username from arguments and delegates to GitLabClient.get_user_details()
def handle_get_user_details(client: GitLabClient, arguments: Optional[Dict[str, Any]]) -> Dict[str, Any]: """Handle getting comprehensive user profile""" user_id = get_argument(arguments, "user_id") username = get_argument(arguments, "username") return client.get_user_details(user_id=user_id, username=username) - src/mcp_gitlab/tool_handlers.py:1074-1075 (registration)Mapping of tool name 'TOOL_GET_USER_DETAILS' ('gitlab_get_user_details') to its handler function in TOOL_HANDLERS dictionary, used by server.call_tool()
TOOL_GET_USER_DETAILS: handle_get_user_details, TOOL_GET_MY_PROFILE: handle_get_my_profile, - Tool schema definition including inputSchema with parameters for username (required), include_projects and include_groups (optional)
types.Tool( name=TOOL_GET_USER_DETAILS, description=desc.DESC_GET_USER_DETAILS, inputSchema={ "type": "object", "properties": { "username": {"type": "string", "description": "Username string"}, "include_projects": {"type": "boolean", "description": "Include user's projects", "default": False}, "include_groups": {"type": "boolean", "description": "Include user's groups", "default": False} }, "required": ["username"] } ), - src/mcp_gitlab/server.py:982-991 (registration)MCP server registration of the tool in handle_list_tools(), defining name, description, and inputSchema (user_id or username)
name=TOOL_GET_USER_DETAILS, description=desc.DESC_GET_USER_DETAILS, inputSchema={ "type": "object", "properties": { "user_id": {"type": "string", "description": "Numeric user ID"}, "username": {"type": "string", "description": "Username string"} } } ), - src/mcp_gitlab/constants.py:252-252 (helper)Constant definition TOOL_GET_USER_DETAILS = "gitlab_get_user_details" used across the codebase for the tool name
TOOL_GET_USER_DETAILS = "gitlab_get_user_details"