Tools

Create Release

Create a new release for a project, or list existing releases. Releases are associated with a Git tag and can include release notes and milestone associations.

Manage Pipeline

Trigger, retry, or cancel a CI/CD pipeline. Use "create" to trigger a new pipeline on a given ref (branch/tag). Use "retry" or "cancel" to manage an existing pipeline by its ID. Optionally pass CI/CD variables when triggering.

Manage Project

Create, update, fork, or delete a GitLab project. Use the **action** field to specify the operation. For creating, provide a name and optional settings. For updating, provide the project ID and fields to change. For forking, provide the source project ID.

Manage Issue

Create, update, close, reopen, or delete a GitLab issue. Supports setting title, description, labels, assignees, milestone, due date, weight, and confidentiality. Use **stateEvent** to close or reopen an existing issue.

List Merge Requests

List GitLab merge requests, optionally scoped to a project. Filter by state, labels, source/target branch, author, assignee, or reviewer. Supports pagination.

Manage Merge Request

Create, update, or merge a GitLab merge request. Create MRs with source/target branches, reviewers, and labels. Update MR properties, close/reopen, or accept and merge. Use **action** "merge" to accept and merge the MR.

List Issues

List GitLab issues filtered by project, state, labels, milestone, assignee, author, or search term. Can list issues globally or within a specific project. Supports pagination.

List Pipelines

List CI/CD pipelines for a project. Filter by status, ref (branch/tag), SHA, source, or pipeline name. Useful for monitoring build and deployment status.

Add Comment

Add a comment (note) to an issue or merge request. Supports Markdown formatting. Can also list existing comments on an issue or merge request.

Get Project

Retrieve detailed information about a specific GitLab project by its ID or URL-encoded path (e.g. "my-group/my-project").

Browse Repository

Browse a project's repository tree, read file contents, or compare branches. Use "tree" to list directory contents, "file" to read a specific file, or "compare" to view the diff between two refs (branches, tags, or SHAs).

Manage Branch

List, create, or delete branches in a project repository. Use "list" to search existing branches, "create" to create a new branch from a ref, or "delete" to remove a branch.

Search

Search across GitLab for projects, issues, merge requests, milestones, code (blobs), commits, wiki content, and users. Can search globally, within a group, or within a specific project.

List Groups

List GitLab groups accessible to the authenticated user. Filter by search term or ownership.

List Projects

List GitLab projects accessible to the authenticated user. Filter by search term, ownership, membership, visibility, and archived status. Supports pagination for large result sets.

Get Pipeline Jobs

List all jobs in a CI/CD pipeline, or get details and logs for a specific job. Use this to inspect job statuses, view build logs, retry failed jobs, or cancel running jobs.

Manage Repository File

Create, update, or delete a file in a GitLab repository. Each operation creates a commit. Provide file content and a commit message. For binary files, use base64 encoding.

Run Pipeline

Create and run a new pipeline on a specified branch or tag. Optionally pass CI/CD variables for the pipeline run. Can also retry or cancel an existing pipeline.

Lint CI Config

Validate a `.gitlab-ci.yml` configuration file for syntax errors and configuration issues. Optionally performs a dry run to simulate pipeline creation. Returns validation status, errors, warnings, and optionally the merged YAML.

Manage Environments

List, create, update, stop, or delete deployment environments for a project. Environments represent targets like staging or production. Supports filtering by name, search term, and state.

List Deployments

List deployments for a project, optionally filtered by environment or status. Returns deployment details including the associated commit, environment, and timing information.

Manage Job

Perform actions on a CI/CD job: get details, retry a failed job, cancel a running job, play a manual job, erase job artifacts/logs, or retrieve the job log output.

List Jobs

List CI/CD jobs for a specific pipeline or across a project. Filter by job scope (status). Returns job name, stage, status, duration, and associated pipeline.

Get Pipeline

Retrieve detailed information about a specific pipeline, including status, duration, coverage, source, and associated user. Also optionally fetches test report summary.

Manage Ci/cd Variables

List, create, update, or delete CI/CD variables at the project or group level. Variables can be scoped to environments, marked as protected (limited to protected branches/tags), or masked in logs.

Manage Pipeline Triggers

Create, list, update, or delete pipeline trigger tokens. Trigger tokens allow external services to run pipelines via the trigger API. Can also fire a pipeline using a trigger token with custom variables.

Delete Pipeline

Permanently delete a pipeline and all of its associated resources (jobs, artifacts, logs). This action is irreversible.

Manage Pipeline Schedules

Create, list, update, or delete scheduled pipelines that run at recurring intervals using cron syntax. Schedule variables can be added, updated, or removed as part of schedule management.

Manage Runners

List, view, update, pause/resume, or delete CI/CD runners. Runners can be listed for a specific project or across all accessible runners. Update runner configuration including tags, description, and access level.

Get Test Report

Retrieve the unit test report for a pipeline, including total counts, success/failure breakdowns, test suites, and individual test case details. Use "summary" mode for a quick overview or "full" mode for detailed test case information.