gitlab_get_user_commits

Track specific user’s code contributions by retrieving their authored commits across projects or within a project. Filter by time, branch, or project scope for detailed insights into development activity and performance.

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
`branch`	No	Filter by specific branch
`include_stats`	No	Include file change statistics
`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
`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
`project_id`	No	Optional project scope filter
`since`	No	Commits after date (YYYY-MM-DD)
`until`	No	Commits before date (YYYY-MM-DD)
`user_id`	No	Numeric user ID
`username`	No	Username string

Input Schema (JSON Schema)

{
  "properties": {
    "branch": {
      "description": "Filter by specific branch",
      "type": "string"
    },
    "include_stats": {
      "default": false,
      "description": "Include file change statistics",
      "type": "boolean"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination\nType: integer\nRange: ≥1\nDefault: 1\nExample: 3 (to get the third page of results)\nNote: Use with per_page to navigate large result sets",
      "minimum": 1,
      "type": "integer"
    },
    "per_page": {
      "default": 50,
      "description": "Number of results per page\nType: integer\nRange: 1-100\nDefault: 20\nExample: 50 (for faster browsing)\nTip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "project_id": {
      "description": "Optional project scope filter",
      "type": "string"
    },
    "since": {
      "description": "Commits after date (YYYY-MM-DD)",
      "type": "string"
    },
    "until": {
      "description": "Commits before date (YYYY-MM-DD)",
      "type": "string"
    },
    "user_id": {
      "description": "Numeric user ID",
      "type": "string"
    },
    "username": {
      "description": "Username string",
      "type": "string"
    }
  },
  "type": "object"
}

MCP GitLab Server