GitLab MCP Server

Create a new issue

Add an emoji reaction to an issue (e.g. thumbsup, rocket, eyes)

Create an issue link between two issues

Add a note to an issue, optionally replying to a discussion thread

Add an emoji reaction to an issue note. Pass discussion_id for discussion thread replies.

Create a new label in a project

Create a new merge request

Add a new discussion note to an existing merge request thread

Add an emoji reaction to a merge request (e.g. thumbsup, rocket, eyes)

Add a new note to a merge request

Add an emoji reaction to a merge request note. Pass discussion_id for discussion thread replies.

Create a new thread on a merge request

Create a new milestone

Create a new note (comment) to an issue or merge request

Create or update a file in a GitLab project

Create a new pipeline for a branch or tag

Create a new pipeline schedule for a branch or tag

Create a variable for a pipeline schedule

Create a project pipeline trigger

Create a CI/CD variable for a project

Create a new release

Create release evidence (Premium/Ultimate)

Create a new GitLab project

Create a snippet — project-scoped when project_id is given, otherwise a personal snippet. Requires title plus either file_name + content (single file) or files[] (multi-file); the two shapes cannot be mixed.

Create a new repository tag

Create a timeline event on an incident

Create a webhook on a project or group

Create a wiki page in a project

Create a work item (issue, task, incident, epic, etc.) with full field support

Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)

Add a note to a work item (supports Markdown, internal notes, threads)

Add an emoji reaction to a work item note (comment, thread, or thread reply)

Delete branch from project

Delete a deployment

Delete a draft note

Delete a stopped environment

Delete a group milestone

Delete a CI/CD variable from a group

Delete a wiki page from a group

Delete an issue

Remove an emoji reaction from an issue

Delete an issue link

Remove an emoji reaction from an issue note. Pass discussion_id for discussion thread replies.

Delete a label from a project

Delete a discussion note on a merge request

Remove an emoji reaction from a merge request

Delete an existing merge request note

Remove an emoji reaction from a merge request note. Pass discussion_id for discussion thread replies.

Delete a milestone

Delete a pipeline. Requires the project Owner role, cannot be undone, and does not automatically delete child pipelines.

Delete a pipeline schedule

Delete a variable from a pipeline schedule

Delete a project pipeline trigger

Delete a CI/CD variable from a project

Delete a release (does not delete the tag)

Schedule deletion of stopped review-app environments one week later; dry_run defaults to true and actual scheduling requires dry_run=false

Delete a snippet

Delete a repository tag

Delete a project or group webhook

Delete a wiki page from a project

Remove an emoji reaction from a work item

Remove an emoji reaction from a work item note (comment, thread, or thread reply)

Discover and activate additional tool categories for this session. Call without arguments to see available categories.

Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment

Description is built at runtime.

Description is built at runtime.

Description is built at runtime.

Edit an existing group milestone

Edit an existing milestone

Erase a pipeline job log and artifacts

Execute a GitLab GraphQL query

Fork a project to your account or specified namespace

Get branch details (commit, protection status)

Get diffs between two branches or commits

Get details for a GitLab CI/CD Catalog resource, including versions and components

Get details of a specific commit

Get changes/diffs of a specific commit

Get dependency proxy settings for a group

Get deployment details, including approval_summary, approvals, and pending_approval_count when GitLab provides them

Get a single draft note from a merge request

Get details of a specific environment

Get git blame for a file at a given ref. Each entry maps a contiguous range of source lines to the commit that last changed them (id, author, authored_date, message). Use range_start/range_end to limit blame to specific lines.

Get contents of a file or directory from a GitLab project

Get details of a specific group milestone

Get burndown events for a specific group milestone

Get issues associated with a specific group milestone

Get merge requests associated with a specific group milestone

Get a single CI/CD variable from a group

Get details of a specific group wiki page

Get details of a specific issue. Returns the issue with a slim nested milestone by default; set full_response=true for the complete milestone object

Get a specific issue link

Get content of a single file from a job's artifacts

Get a single label from a project

Get details of a merge request (merge_request_iid or source_branch required). Set include_summaries=true for deployment/commit/approval summaries

Get merge request approval details including approvers

Get the conflicts of a merge request

Get the changes/diffs of a merge request (merge_request_iid or source_branch required)

Get a single discussion item for a merge request

Get diffs for specific files from a merge request (merge_request_iid or source_branch required)

Get a specific note for a merge request

List notes for a merge request

Get a specific version of a merge request

Get details of a specific milestone

Get burndown events for a specific milestone

Get issues associated with a specific milestone

Get merge requests associated with a specific milestone

Get details of a namespace (user or group) by ID or path. Groups are namespaces with kind='group'.

Get details of a specific pipeline

Get details of a GitLab pipeline job number

Get the output/trace of a pipeline job with optional pagination

Get details of a specific pipeline schedule, including its variables and last pipeline

Get a single variable of a pipeline schedule

Get pipeline test report

Get pipeline test report summary

Get a project pipeline trigger

Get variables configured for a pipeline

Get details of a specific project

List events for a project (before/after: YYYY-MM-DD)

Get a single CI/CD variable from a project

Get details of a single protected branch (access levels, force push settings)

Get details of a single protected tag or wildcard (create access levels)

Get a release by tag name

List files and directories in a repository

Get one runner by ID

Get a snippet's metadata. Set include_content=true to also fetch the raw file content.

Get a repository tag by name

Get the X.509 signature of a signed tag (404 if unsigned)

List timeline events for an incident

Get user details by ID

Get GitLab user details by usernames

Get full details of a specific vulnerability

Get full details of a specific webhook event

Get details of a specific wiki page

Get a work item with full details including status, hierarchy, type, and widgets

DANGER: bypasses group and project restrictions, tool allowlists (GITLAB_TOOLS and GITLAB_DENIED_TOOLS_REGEX on other tools), and individual tool safety checks. The full token scope is exposed.

Verify server status and authentication. Always reports the MCP server version (mcp_server_version). When authenticated, also reports the GitLab instance version from GET /api/v4/version (version, revision, enterprise). Version lookup failures do not fail the health check — those fields are omitted.

Return a short GitLab workflow guide. Omit topic for the overview and topic list.

List branches in project with search filter

List GitLab CI/CD Catalog resources/components visible to the user

List statuses for a commit

List repository commits with filtering options

List custom field definitions for a work item type

List cached dependency proxy blobs for a group

List merge requests shipped with a deployment

List deployments with filtering options

List draft notes for a merge request

List environments in a project

List events for the authenticated user (before/after: YYYY-MM-DD)

List group iterations with filtering options

List members of a GitLab group with optional name or username search

List merge requests across all projects of a group and its subgroups

List group milestones with filtering options

List projects in a group

List CI/CD variables for a group

List wiki pages in a group

List discussions for an issue

List all emoji reactions on an issue

List all issue links for a specific issue

List all emoji reactions on an issue note. Pass discussion_id for discussion thread replies.

List issues (default: created by current user; use scope='all' for all)

List artifact files in a job's archive

List labels for a project

List changed file paths in a merge request without diff content (merge_request_iid or source_branch required)

List merge request diffs with pagination (merge_request_iid or source_branch required)

List all emoji reactions on a merge request

List all emoji reactions on a merge request note. Pass discussion_id for discussion thread replies.

List pipelines for a merge request with pagination

List all versions of a merge request

List merge requests (without project_id: user's MRs; with project_id: project MRs)

List milestones with filtering options

List all namespaces (users and groups) available to the current user. Filter by kind='group' for groups only.

List all jobs in a specific pipeline

List the pipelines that a pipeline schedule has triggered

List pipeline schedules in a project, optionally filtered to active or inactive

List trigger jobs (bridges) in a pipeline

List project pipeline trigger tokens

List pipelines with filtering options

List members of a GitLab project

List runners available to a project

List CI/CD variables for a project

List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)

List projects accessible by the current user

List protected branches in a project, supports search filter

List protected tags in a project

List all releases for a project

List snippets — project snippets when project_id is given, otherwise personal snippets

List repository tags for a project

List GitLab to-do items for the current user

List recent webhook events (past 7 days)

List webhooks for a project or group

List wiki pages in a project

List all emoji reactions on a work item

List all emoji reactions on a work item note (comment, thread, or thread reply)

List notes and discussions on a work item

List available statuses for a work item type (Premium/Ultimate)

List work items with filters (type, state, search, assignees, labels)

Mark all pending GitLab to-do items as done for the current user

Mark a GitLab to-do item as done

Merge a merge request

Move a work item to a different project

List discussion items for a merge request

List issues assigned to the authenticated user

Check if the current workflow has incomplete tasks. Returns whether the agent should continue or can stop.

Clear state for a given OMG mode or all modes

Create a new PRD with title, description, and stories

Delete a project memory entry by key

Get information about omg-autopilot phases

List all currently active OMG modes

Advance the omg-autopilot workflow to the next phase. Returns the new phase details.

Read project memory entries. Optionally filter by category or key.

Read the current PRD (Product Requirements Document) with all stories and their status

Read the current state for a given OMG mode (omg-autopilot, ralph, ultrawork, ultraqa, team, self-improve)

Recommend the best model for a task based on complexity analysis. Maps OMC model tiers (HIGH/MEDIUM/LOW) to available VS Code Copilot models.

Update a story's status (passes: true/false) and optionally add verification evidence

Get the next unverified story and its acceptance criteria for verification

Write or update a project memory entry

Write or update state for a given OMG mode. Merges with existing state.

Fetch the current GitLab Orbit graph schema (node and edge types)

Check GitLab Orbit indexing status for the enabled scope

List the MCP tool definitions exposed by GitLab Orbit

Execute a GitLab Orbit graph query over the indexed SDLC knowledge graph

Run a manual pipeline job

Play multiple manual pipeline jobs sequentially

Run a pipeline schedule immediately

Promote a milestone to the next stage

Protect a repository branch (set push/merge/unprotect access levels)

Protect a repository tag or wildcard (set who can create it)

Publish a single draft note

Schedule purge of all cached dependency proxy blobs for a group

Push multiple files in a single commit

Rebase the source branch of a merge request onto its target branch

Resolve a thread on a merge request

Retry a failed or canceled pipeline

Retry a failed or canceled pipeline job

Search for code across all projects (requires advanced search or Zoekt)

Search for code within a specific group (requires advanced search or Zoekt)

Search for code within a specific project (requires advanced search or Zoekt)

Search for GitLab projects

Stop an environment

Stop eligible stale environments; protected environments are excluded and environments are stopped, not deleted

Take ownership of a pipeline schedule

Trigger a pipeline with a pipeline trigger token

Unapprove a merge request

Remove protection from a previously protected branch

Remove protection from a previously protected tag or wildcard

Change the default branch of a project

Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)

Update a deployment status

Update an existing draft note

Update an environment

Update an existing CI/CD variable in a group

Update a wiki page in a group

Update an issue. Returns a slim confirmation by default; set full_response=true for the complete updated issue object

Apply a patch (search/replace or unified diff) to an issue description. Reduces token usage by allowing small changes without sending the full description. Supports dry_run to preview changes and create_note to summarize updates.

Modify an existing issue thread note

Update an existing label in a project

Update a merge request (merge_request_iid or source_branch required)

Update a discussion note on a merge request

Modify an existing merge request note

Update pipeline metadata

Update an existing pipeline schedule

Update a variable of a pipeline schedule

Update a project pipeline trigger

Update project settings such as description, visibility, default branch, and feature access levels

Update an existing CI/CD variable in a project

Update an existing protected branch rule in place (access levels, force push, code owner approval)

Update an existing release

Update an existing snippet (provide at least one field to change). For multi-file edits — renames, deletions, additions — pass files[] with action (create/update/delete/move) and previous_path. The file_name + content shortcut still works for single-file content replacement.

Update an existing project or group webhook

Update a wiki page in a project

Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)

Description is built at runtime.

Validate provided GitLab CI/CD YAML content for a project

Validate an existing .gitlab-ci.yml configuration for a project

Verify if a namespace path exists. Use parent_id to scope the check to a specific parent namespace — required for nested namespaces where the same path may exist under different parents.

Wait for a job to reach a terminal status

Wait for a pipeline to reach a terminal status

Get current authenticated user details