Get detailed information about a specific GitLab project (read-only)

Get issues from a specific GitLab project (read-only)

Get merge requests from a specific GitLab project (read-only)

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 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.

Get list of available GraphQL queries and mutations from the GitLab schema

Get CI/CD pipelines for a merge request, including status, duration, and stages

Get jobs for a specific pipeline, including status, stage, duration, and retry/cancel info

Get diff statistics for a merge request, including per-file additions/deletions and diff refs

Get commits for a merge request (excluding merge commits), with commit count and details

Get notes (comments) on an issue or merge request, including system notes and inline MR comments

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.

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.

List milestones for a project or group with progress statistics (total/closed issue counts)

List iterations (sprints) for a group with cadence info. Requires GitLab Premium/Ultimate.

Get time tracking data (estimate, spent, timelogs) for an issue or merge request

Get approval and reviewer status for a merge request, including who approved and review states

Get aggregate project statistics: open issues/MRs, star/fork counts, storage sizes, commit count, last pipeline status, release count, and language breakdown

List all GitLab broadcast messages (instance-wide announcements). Read-only.

Get a specific GitLab broadcast message by ID.

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 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 a specific user's public GitLab activity feed by username or numeric ID. Use for tracking what a teammate has been working on.

List activity events for a single GitLab project — commits pushed, MRs opened/merged, issues touched, notes added. Accepts project full path or numeric ID.

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.

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.

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.

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)".

Get information about the current authenticated GitLab user

List projects accessible to the user (requires authentication to see private projects)

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.

Create a new issue in a GitLab project (requires user authentication with write permissions)

Create a new merge request in a GitLab project (requires user authentication with write permissions)

Add a comment/note to an issue or merge request (requires user authentication)

Delete a comment (note) on a GitLab issue or merge request. Requires a user token belonging to the note author or a maintainer.

Edit the body of an existing comment (note) on a GitLab issue or merge request. Requires a user token belonging to the note author.

Retry or cancel a CI/CD pipeline (requires user authentication with write permissions)

Create a GitLab broadcast message. Requires administrator privileges on the GitLab instance.

Update an existing GitLab broadcast message. Requires administrator privileges.

Delete a GitLab broadcast message by ID. Requires administrator privileges.

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 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 a previously-marked-done to-do item back to pending state. Accepts the todo's ID (numeric or full gid://gitlab/Todo/N form).

Update an issue (title, description, assignees, labels, due date) with schema-aware mutations

Delete a GitLab issue. Requires a user token with permission to delete issues in the project (typically the issue author or a maintainer).

Update a merge request (title, description, assignees, reviewers, labels) with schema-aware mutations

Resolve a GitLab path to either a project or group and list group projects when applicable

List projects inside a GitLab group (optionally filter by search term)

List available fields on a GraphQL type using introspected schema (requires schema to be introspected)

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 for GitLab projects by name or description

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 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.

Get all issues assigned to a specific user - uses proper GraphQL filtering for reliable results

Get merge requests for a specific user (as author or assignee) - uses proper GraphQL filtering

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.

Search for GitLab users by username or name - useful for finding team members or contributors

Search for GitLab groups and organizations

Search for labels in a project or group, with optional text filtering

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.

Browse repository files and folders - essential for exploring codebase structure

Get the content of a specific file from a GitLab repository - crucial for code analysis

List group members with access levels, optionally filtered by search term