gitlab_get_user_issue_comments
Retrieve all issue comments authored by a specific user across GitLab projects to track engagement, analyze collaboration patterns, and generate participation reports.
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
{
"username": "johndoe",
"since": "2024-01-01",
"sort": "created"
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | Username string | |
| project_id | No | Optional project scope filter | |
| since | No | Comments after date (YYYY-MM-DD) | |
| until | No | Comments before date (YYYY-MM-DD) | |
| 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:916-936 (handler)Main execution handler for the gitlab_get_user_issue_comments tool. Extracts parameters and delegates to GitLabClient.get_user_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 and tool registration for gitlab_get_user_issue_comments using MCP types.Tool.
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:1092-1096 (registration)Registration of the handler function in the TOOL_HANDLERS dispatch dictionary used by the MCP server.
# 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:271-271 (helper)Constant defining the tool name string used across modules.
TOOL_GET_USER_ISSUE_COMMENTS = "gitlab_get_user_issue_comments"