gitlab_get_user_commits
Retrieve commits authored by a specific user to track code contributions, analyze development activity, and prepare for code reviews with filtering by project, branch, or time period.
Instructions
List all commits authored by a specific user across projects or within a project.
Shows commits where the user is the author (wrote the code). Use this tool to see what code changes a user has authored.
Examples:
Code contribution analysis: get_user_commits(user_id=123)
Developer productivity metrics
Code review preparation
For merge commits specifically, use 'gitlab_get_user_merge_commits' instead.
Retrieve all commits authored by the specified user with flexible filtering by time period, branch, or project scope.
Returns commit information with:
Commit details: SHA, message, timestamp
Code changes: files modified, additions, deletions
Context: branch, project, merge request associations
Author info: email, committer details
Statistics: impact, complexity metrics
Use cases:
Code contribution tracking
Development velocity analysis
Code review preparation
Performance evaluations
Parameters:
user_id: Numeric user ID
username: Username string (use either user_id or username)
project_id: Optional project scope filter
branch: Filter by specific branch
since: Commits after date (YYYY-MM-DD)
until: Commits before date (YYYY-MM-DD)
include_stats: Include file change statistics
per_page: Results per page (default: 20)
page: Page number (default: 1)
Example: Get user commits from main branch last month
{
"username": "johndoe",
"branch": "main",
"since": "2024-01-01",
"until": "2024-01-31",
"include_stats": true
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | No | Numeric user ID | |
| username | No | Username string | |
| project_id | No | Optional project scope filter | |
| branch | No | Filter by specific branch | |
| since | No | Commits after date (YYYY-MM-DD) | |
| until | No | Commits before date (YYYY-MM-DD) | |
| include_stats | No | Include file change statistics | |
| per_page | No | Number of results per page Type: integer Range: 1-100 Default: 20 Example: 50 (for faster browsing) Tip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing | |
| page | No | Page number for pagination Type: integer Range: ≥1 Default: 1 Example: 3 (to get the third page of results) Note: Use with per_page to navigate large result sets |
Implementation Reference
- src/mcp_gitlab/tool_handlers.py:833-856 (handler)The main handler function for the gitlab_get_user_commits tool. Extracts parameters from arguments and calls GitLabClient.get_user_commits() to retrieve commits authored by the specified user.
def handle_get_user_commits(client: GitLabClient, arguments: Optional[Dict[str, Any]]) -> Dict[str, Any]: """Handle getting user's commits""" user_id = get_argument(arguments, "user_id") username = get_argument(arguments, "username") project_id = get_argument(arguments, "project_id") branch = get_argument(arguments, "branch") since = get_argument(arguments, "since") until = get_argument(arguments, "until") include_stats = get_argument(arguments, "include_stats", False) per_page = get_argument(arguments, "per_page", DEFAULT_PAGE_SIZE) page = get_argument(arguments, "page", 1) return client.get_user_commits( user_id=user_id, username=username, project_id=project_id, branch=branch, since=since, until=until, include_stats=include_stats, per_page=per_page, page=page ) - src/mcp_gitlab/server.py:1115-1131 (schema)Tool schema definition in server.py list_tools() method, specifying input parameters and validation for the gitlab_get_user_commits tool.
name=TOOL_GET_USER_COMMITS, description=desc.DESC_GET_USER_COMMITS, inputSchema={ "type": "object", "properties": { "user_id": {"type": "string", "description": "Numeric user ID"}, "username": {"type": "string", "description": "Username string"}, "project_id": {"type": "string", "description": "Optional project scope filter"}, "branch": {"type": "string", "description": "Filter by specific branch"}, "since": {"type": "string", "description": "Commits after date (YYYY-MM-DD)"}, "until": {"type": "string", "description": "Commits before date (YYYY-MM-DD)"}, "include_stats": {"type": "boolean", "description": "Include file change statistics", "default": False}, "per_page": {"type": "integer", "description": desc.DESC_PER_PAGE, "default": DEFAULT_PAGE_SIZE, "minimum": 1, "maximum": MAX_PAGE_SIZE}, "page": {"type": "integer", "description": desc.DESC_PAGE_NUMBER, "default": 1, "minimum": 1} } } ), - src/mcp_gitlab/tool_handlers.py:1086-1097 (registration)Registration mapping in TOOL_HANDLERS dictionary that associates the tool name TOOL_GET_USER_COMMITS with its handler function. Used in server.py handle_call_tool().
# User's Code & Commits handlers TOOL_GET_USER_COMMITS: handle_get_user_commits, TOOL_GET_USER_MERGE_COMMITS: handle_get_user_merge_commits, TOOL_GET_USER_CODE_CHANGES_SUMMARY: handle_get_user_code_changes_summary, TOOL_GET_USER_SNIPPETS: handle_get_user_snippets, # User's Comments & Discussions handlers TOOL_GET_USER_ISSUE_COMMENTS: handle_get_user_issue_comments, TOOL_GET_USER_MR_COMMENTS: handle_get_user_mr_comments, TOOL_GET_USER_DISCUSSION_THREADS: handle_get_user_discussion_threads, TOOL_GET_USER_RESOLVED_THREADS: handle_get_user_resolved_threads, } - src/mcp_gitlab/constants.py:265-265 (helper)Constant definition for the tool name string, used consistently across schema definitions and handler registrations.
TOOL_GET_USER_COMMITS = "gitlab_get_user_commits" - Alternative/backup schema definition in tool_definitions.py (potentially unused), matching the active schema in server.py.
name=TOOL_GET_USER_COMMITS, description=desc.DESC_GET_USER_COMMITS, inputSchema={ "type": "object", "properties": { "username": {"type": "string", "description": "Username string"}, "project_id": {"type": "string", "description": "Optional project scope filter"}, "since": {"type": "string", "description": "Commits after date (YYYY-MM-DD)"}, "until": {"type": "string", "description": "Commits before date (YYYY-MM-DD)"}, "per_page": {"type": "integer", "description": desc.DESC_PER_PAGE, "default": DEFAULT_PAGE_SIZE, "minimum": 1, "maximum": MAX_PAGE_SIZE}, "page": {"type": "integer", "description": desc.DESC_PAGE_NUMBER, "default": 1, "minimum": 1} }, "required": ["username"] } ),