gitlab_get_user_issue_comments
Retrieve all issue comments made by a specific GitLab user, including content, timestamps, issue context, and interaction metrics. Filter by date, project, or issue state to analyze engagement, collaboration, and communication patterns.
Instructions
Get all comments authored by a user on issues
Retrieve all issue comments and notes created by the specified user across all accessible projects and time periods.
Returns comment information with:
Comment details: content, timestamp, issue context
Issue info: title, state, project association
Interaction metrics: replies, reactions, mentions
Context: thread position, related discussions
Impact: influence on issue resolution
Use cases:
Track user engagement in discussions
Monitor communication patterns
Analyze collaboration effectiveness
Generate participation reports
Parameters:
user_id: Numeric user ID
username: Username string (use either user_id or username)
project_id: Optional project scope filter
since: Comments after date (YYYY-MM-DD)
until: Comments before date (YYYY-MM-DD)
issue_state: Filter by issue state (opened, closed, all)
sort: Sort order (created, updated, project)
per_page: Results per page (default: 20)
page: Page number (default: 1)
Example: Get recent issue comments
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 | Comments after date (YYYY-MM-DD) | |
| until | No | Comments before date (YYYY-MM-DD) | |
| username | Yes | Username string |
Implementation Reference
- src/mcp_gitlab/tool_handlers.py:916-935 (handler)The main handler function implementing the gitlab_get_user_issue_comments tool. It extracts parameters from arguments, validates username, and delegates to GitLabClient.get_user_issue_comments() to fetch the user's issue comments.def handle_get_user_issue_comments(client: GitLabClient, arguments: Optional[Dict[str, Any]]) -> Dict[str, Any]: """Handle getting user's issue comments""" username = get_argument(arguments, "username") if not username: raise ValueError("username is required") project_id = get_argument(arguments, "project_id") since = get_argument(arguments, "since") until = get_argument(arguments, "until") per_page = get_argument(arguments, "per_page", DEFAULT_PAGE_SIZE) page = get_argument(arguments, "page", 1) return client.get_user_issue_comments( username=username, project_id=project_id, since=since, until=until, per_page=per_page, page=page )
- Input schema definition for the tool using types.Tool, specifying parameters like username (required), project_id, date filters, pagination.types.Tool( name=TOOL_GET_USER_ISSUE_COMMENTS, description=desc.DESC_GET_USER_ISSUE_COMMENTS, inputSchema={ "type": "object", "properties": { "username": {"type": "string", "description": "Username string"}, "project_id": {"type": "string", "description": "Optional project scope filter"}, "since": {"type": "string", "description": "Comments after date (YYYY-MM-DD)"}, "until": {"type": "string", "description": "Comments 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"] } ),
- src/mcp_gitlab/tool_handlers.py:1093-1093 (registration)Registration of the tool handler in the TOOL_HANDLERS dictionary mapping tool name constant to the handle_get_user_issue_comments function.TOOL_GET_USER_ISSUE_COMMENTS: handle_get_user_issue_comments,
- src/mcp_gitlab/constants.py:271-271 (helper)Constant definition for the tool name string used across the codebase.TOOL_GET_USER_ISSUE_COMMENTS = "gitlab_get_user_issue_comments"