GitLab MCP Server

Delete a branch from a project repository.

List commits in a project repository with filtering by ref, date range, path, or author.

Get a single commit by SHA, including optional stats.

Get the unified diff for a single commit.

Compare two refs (branch, tag, or commit) and return the diff and commits between them.

List files and directories in a project repository at a given path and ref.

Get a file's contents and metadata from a project repository at a given ref. Returns base64 content inline for text files; binary content can be downloaded separately via raw=true.

Create a new file or update an existing one in a repository with a commit. Pass inline 'content' or a Gumloop 'file_link' to upload existing bytes from file storage.

Delete a file from a repository with a commit.

Download a snapshot of a project repository as a compressed archive. The archive is uploaded to Gumloop file storage and a public URL is returned.

Push a CI/build status onto a commit (useful for reporting status from external systems like deploy bots).

List all CI/build statuses recorded against a commit.

Add a comment to a commit. With path + line + line_type, becomes an inline comment on a specific line of the diff.

List merge requests that include a given commit.

List Git tags in a project repository.

Create a new Git tag in a project repository.

List releases for a project.

Get a single release by tag name.

Create a single commit applying multiple file actions atomically (create, update, delete, move, chmod). Equivalent to `git add ... && git commit && git push` for many files in one shot. Each action may pass inline 'content' or a Gumloop 'file_link'.

Apply a commit's changes to another branch (git cherry-pick).

Revert a commit on a branch by creating a new commit that undoes its changes (git revert).

Run a multi-step git workflow against a project. Clones server-side using the OAuth token, runs the steps in a temp workdir, commits, pushes, and cleans up. Use when REST tools can't express what you need (rebase, conflict resolution, applying patches, complex merges). For simple multi-file commits prefer commit_files.

Delete every branch already merged into the project's default branch. Protected branches are skipped.

Auto-generate a CHANGELOG.md entry from commit-message trailers between two refs and (optionally) commit it.

Get blame ranges for a file: which commit and author last touched each block of lines.

Get the best common ancestor commit between two or more refs (useful for computing diffs).

List repository contributors with their commit counts and additions/deletions totals.

Fork a project into the authenticated user's namespace or a specified namespace.

Star a project as the authenticated user.

Remove the authenticated user's star from a project.

Archive a project (read-only, removed from active project lists).

Unarchive a previously-archived project (restored to active status).

List subgroups of a group.

Create a new release attached to a tag (creates the tag if it doesn't exist and 'ref' is supplied).

List issues in a project with filtering, sorting, and pagination.

Get a single issue by its internal project ID (iid).

Create a new issue in a project.

Update an existing issue. Use state_event='close' or 'reopen' to change state.

Delete an issue. Only project owners can delete issues.

List comments (notes) on an issue.

Add a comment (note) to an issue.

Move an issue to a different project. The original issue is closed and replaced with a link to the new one.

Clone an issue into another project, optionally copying notes.

List links from an issue to related/blocked/blocking issues.

Link two issues with a relationship (relates_to, blocks, is_blocked_by).

Remove a link between two issues.

Edit the body of an existing comment on an issue.

Delete a comment from an issue.

Add an emoji reaction to an issue (e.g. 'thumbsup', 'heart').

List merge requests in a project with filtering, sorting, and pagination.

Get a single merge request by its internal project ID (iid).

Create a new merge request.

Update a merge request. Use state_event='close' or 'reopen' to change state.

Merge a merge request. Optionally squash, set commit messages, and remove the source branch.

Rebase a merge request's source branch onto its target branch. Runs asynchronously on GitLab.

List comments (notes) on a merge request.

Add a comment (note) to a merge request.

Edit the body of an existing comment on a merge request.

Delete a comment from a merge request.

Add an emoji reaction to a merge request (e.g. 'thumbsup', 'heart').

List per-file diffs of a merge request.

List commits included in a merge request.

List labels defined on a project.

Create a new label on a project.

Update a project label's name, color, description, or priority.

Delete a project label.

List milestones defined on a project.

Create a new milestone on a project.

List issue boards for a project (Kanban-style boards).

List all members of a project, including those inherited from groups.

Add a user to a project as a member with a given access level.

Upload a file to a project from Gumloop file storage. Returns a markdown-ready URL that can be embedded in issue/MR descriptions or comments.

List CI/CD pipelines in a project with filtering by status, ref, source, and date range.

Get the latest pipeline for the most recent commit on a ref (defaults to the project's default branch).

Get a single pipeline by ID with full status details.

Create (trigger) a new pipeline on a branch or tag, optionally with variables and inputs.

Cancel all jobs in a pipeline.

Retry failed or canceled jobs in a pipeline.

List jobs in a project, or jobs scoped to a single pipeline when pipeline_id is provided.

Get a single CI/CD job by ID.

Run a manual job (one with `when: manual` in .gitlab-ci.yml). Optionally pass job variables.

Cancel a single running CI/CD job.

Retry a single failed or cancelled CI/CD job.

Get the trace (log output) of a job. Logs larger than 10 KB are uploaded to Gumloop file storage and returned as a download URL.

Get the unit-test report for a pipeline (test suites + cases with pass/fail counts).

Download a job's artifacts archive (zip). The archive is uploaded to Gumloop file storage and a public URL is returned.