@ttpears/gitlab-mcp-server
GitLab MCP Server with GraphQL discovery
Versions
2.2.4latest2.2.02.1.02.0.12.0.0+ show 24 moreshow less
1.19.01.18.11.18.01.17.01.16.01.15.21.15.11.15.01.14.11.14.01.13.11.13.01.12.41.12.31.12.01.11.11.11.01.10.01.9.01.8.01.7.31.7.21.7.11.7.0Tools 63
delete_issue Delete a GitLab issue. Requires a user token with permission to delete issues in the project (typically the issue author or a maintainer).
update_merge_request Update a merge request (title, description, assignees, reviewers, labels) with schema-aware mutations
get_current_user Get information about the current authenticated GitLab user
get_project Get detailed information about a specific GitLab project (read-only)
get_projects List projects accessible to the user (requires authentication to see private projects)
get_issues Get issues from a specific GitLab project (read-only)
get_merge_requests Get merge requests from a specific GitLab project (read-only)
create_issue Create a new issue in a GitLab project (requires user authentication with write permissions)
create_merge_request Create a new merge request in a GitLab project (requires user authentication with write permissions)
execute_custom_query Execute custom GraphQL queries for complex filtering (e.g., issues with assigneeUsernames: ["user"], labelName: ["bug"]). Use this for structured filtering by assignee/author/labels when search tools return 0 results. Use pagination and limit complexity to avoid timeouts.
execute_rest_read Execute an arbitrary GET request against the GitLab REST API at /api/v4. Open-ended escape hatch for read endpoints not covered by a dedicated tool — e.g. /projects/:id/repository/files, /projects/:id/pipelines/:pipeline_id/test_report, /admin/*. Provide the path beginning with "/" (no host, no /api/v4 prefix) and an optional query object. For writes, use execute_rest_write.
execute_rest_write Execute an arbitrary POST/PUT/PATCH/DELETE request against the GitLab REST API at /api/v4. Open-ended escape hatch for write endpoints not covered by a dedicated tool. Destructive — DELETE is permitted, so check the path before invoking. For reads, use execute_rest_read.
get_available_queries Get list of available GraphQL queries and mutations from the GitLab schema
update_issue Update an issue (title, description, assignees, labels, due date) with schema-aware mutations
resolve_path Resolve a GitLab path to either a project or group and list group projects when applicable
get_group_projects List projects inside a GitLab group (optionally filter by search term)
get_type_fields List available fields on a GraphQL type using introspected schema (requires schema to be introspected)
search_gitlab Text search across GitLab projects and issues (Note: Does not support filtering by assignee/labels - use search_issues for that. MRs cannot be searched globally - use search_merge_requests with username)
search_projects Search for GitLab projects by name or description
search_issues Search for issues with text search and/or structured filtering (assignee, author, labels, state). For filtering by assignee/author/labels without text search, leave searchTerm empty.
search_merge_requests Search merge requests by username (supports "username", "author:username", "assignee:username") or search within a specific project. Note: GitLab does not support global text search for MRs - use projectPath for text searches.
search_users Search for GitLab users by username or name - useful for finding team members or contributors
search_groups Search for GitLab groups and organizations
browse_repository Browse repository files and folders - essential for exploring codebase structure
get_file_content Get the content of a specific file from a GitLab repository - crucial for code analysis
get_merge_request_pipelines Get CI/CD pipelines for a merge request, including status, duration, and stages
get_pipeline_jobs Get jobs for a specific pipeline, including status, stage, duration, and retry/cancel info
manage_pipeline Retry or cancel a CI/CD pipeline (requires user authentication with write permissions)
get_merge_request_diffs Get diff statistics for a merge request, including per-file additions/deletions and diff refs
get_merge_request_commits Get commits for a merge request (excluding merge commits), with commit count and details
get_notes Get notes (comments) on an issue or merge request, including system notes and inline MR comments
get_issue_context Bundle issue body, all notes (paginated up to maxNotes), related merge requests (mentioning), closing merge requests, linked issues (relates_to/blocks/is_blocked_by) into a single call. Use this instead of fanning out across get_issues + get_notes + search_merge_requests when investigating an issue.
get_merge_request_context Bundle MR body, all notes (paginated up to maxNotes, filtered to non-system by default), commits, pipeline summary, reviewers with approval state, and issues this MR will close into a single call. Use this instead of fanning out across get_merge_requests + get_notes + get_merge_request_commits + get_merge_request_pipelines when investigating an MR.
search_notes Full-text search across issue and merge request comments. Scope can be global, a project, or a group. NOTE: on self-hosted GitLab, the "notes" search scope requires Advanced Search (Elasticsearch) to be enabled — without it, this endpoint returns an error. search_gitlab does NOT search note bodies; this tool does.
create_note Add a comment/note to an issue or merge request (requires user authentication)
delete_note Delete a comment (note) on a GitLab issue or merge request. Requires a user token belonging to the note author or a maintainer.
update_note Edit the body of an existing comment (note) on a GitLab issue or merge request. Requires a user token belonging to the note author.
list_milestones List milestones for a project or group with progress statistics (total/closed issue counts)
list_iterations List iterations (sprints) for a group with cadence info. Requires GitLab Premium/Ultimate.
get_time_tracking Get time tracking data (estimate, spent, timelogs) for an issue or merge request
get_merge_request_reviewers Get approval and reviewer status for a merge request, including who approved and review states
get_project_statistics Get aggregate project statistics: open issues/MRs, star/fork counts, storage sizes, commit count, last pipeline status, release count, and language breakdown
list_group_members List group members with access levels, optionally filtered by search term
search_labels Search for labels in a project or group, with optional text filtering
get_user_issues Get all issues assigned to a specific user - uses proper GraphQL filtering for reliable results
get_user_merge_requests Get merge requests for a specific user (as author or assignee) - uses proper GraphQL filtering
list_broadcast_messages List all GitLab broadcast messages (instance-wide announcements). Read-only.
get_broadcast_message Get a specific GitLab broadcast message by ID.
create_broadcast_message Create a GitLab broadcast message. Requires administrator privileges on the GitLab instance.
update_broadcast_message Update an existing GitLab broadcast message. Requires administrator privileges.
delete_broadcast_message Delete a GitLab broadcast message by ID. Requires administrator privileges.
get_work_item Fetch a GitLab work item (issue, task, epic, incident, OKR) by global ID. Returns the raw widgets array so epic hierarchy, health status, iteration, milestone, and dates are all visible. Accepts either a numeric id or a full gid (gid://gitlab/WorkItem/123).
list_work_items List work items within a namespace (group or project fullPath). Supports filtering by type (ISSUE, TASK, EPIC, INCIDENT, OBJECTIVE, KEY_RESULT) and state, plus cursor pagination and fetchAll.
list_my_todos List the authenticated user\'s GitLab to-do items (notifications about issues, MRs, mentions, reviews requested, etc.). Filter by state, action, target type, or group/project. Requires user authentication.
mark_todo_done Mark a single to-do item as done for the authenticated user. Requires the todo\'s ID (numeric or full gid://gitlab/Todo/N form) from list_my_todos.
mark_all_todos_done Mark pending to-do items as done for the authenticated user. With no arguments, marks every pending todo. Optional scoping args (groupPath, projectPath, action, type, authorIds, targetId) narrow which todos are marked. Irreversible without per-item restore_todo calls. Returns the actual list of updated todos.
restore_todo Restore a previously-marked-done to-do item back to pending state. Accepts the todo\'s ID (numeric or full gid://gitlab/Todo/N form).
list_my_events List the authenticated user\'s GitLab activity feed — pushes, MRs, comments, approvals, issue actions. Primary tool for "what did I just do". Requires user authentication.
list_user_events List a specific user\'s public GitLab activity feed by username or numeric ID. Use for tracking what a teammate has been working on.
list_project_events List activity events for a single GitLab project — commits pushed, MRs opened/merged, issues touched, notes added. Accepts project full path or numeric ID.
analytics_user_summary Aggregated activity summary for a user over a time window — totals by action type (pushes, MRs opened/merged, comments, approvals), breakdown by project and by day. Use this instead of list_user_events when you want counts rather than a raw event feed.
analytics_group_summary Aggregated activity summary for an entire group (optionally including subgroups) over a time window — totals by action type (pushes, MRs opened/merged, comments, approvals), with breakdowns by project, by contributor, and by day. Use this to answer "what did this team do" without fanning out across list_project_events yourself.
analytics_review_bottlenecks Aggregate open (non-draft) merge requests across a group or project to surface review bottlenecks. Returns per-reviewer queue stats, age-bucket histogram, and the stalest MRs by updatedAt. MRs with no reviewer assigned are bucketed under "(unassigned)".
Permissions 3
network medium shell high env_vars low