Labsco
zereight logo

Better GitLab MCP Server

โ˜… 1,800

from zereight

An improved GitLab MCP server with bug fixes and enhancements for accessing GitLab resources.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeAdvanced setup
#email#automation#devops#git#security

GitLab MCP Server

English | ํ•œ๊ตญ์–ด | ็ฎ€ไฝ“ไธญๆ–‡

๐Ÿ“– Documentation โ†’ Setup guides, environment variables, and the full tool reference live on the hosted docs site.

New Feature: Dynamic GitLab API URL support with connection pooling! See Dynamic API URL Documentation for details.

@zereight/mcp-gitlab

A comprehensive GitLab MCP server for AI clients. Manage projects, merge requests, issues, pipelines, wiki, releases, tags, milestones, and more through stdio, SSE, and Streamable HTTP.

Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization for VS Code, Claude, Cursor, Copilot, and other MCP clients.

Why use this GitLab MCP?

  • Broad GitLab coverage โ€” projects, repository browsing, merge requests, issues, pipelines, wiki, releases, tags, labels, milestones, and more

  • Flexible auth โ€” Personal Access Token, local OAuth2 browser flow, MCP OAuth proxy, and per-request remote authorization

  • Multiple transports โ€” stdio for local clients, SSE for legacy clients, and Streamable HTTP for modern remote deployments

  • Client-friendly setup โ€” examples for Claude Code, Codex, Antigravity, OpenCode, Copilot, Cline, Roo Code, Cursor, Kilo Code, and Amp Code

  • Self-hosted ready โ€” works with custom GitLab instances, proxy settings, and dynamic API URL routing

Quick start: choose either Personal Access Token or OAuth2 setup below, install @zereight/mcp-gitlab, and use zereight-mcp-gitlab in your MCP client configuration.

Client Setup Guides

Agent Skill Files

Pre-built skill files are available in skills/gitlab-mcp/ for AI agents that support skill/instruction loading (Claude Code, GitHub Copilot, Cursor, etc.).

  • SKILL.md โ€” Core guide (~800 tokens) with toolset overview, key workflows, and parameter hints

  • reference/ โ€” Detailed workflow docs for code review, merge requests, issues, and pipelines

Install with the skills CLI:

Copy & paste โ€” that's it
npx skills add zereight/gitlab-mcp --skill gitlab-mcp-skill

Register the skill directory in your AI client to get optimal tool usage guidance without relying solely on the full ListTools response.

Tools ๐Ÿ› ๏ธ

Click to expand

  • merge_merge_request - Merge a merge request in a GitLab project

  • create_or_update_file - Create or update a single file in a GitLab project

  • search_repositories - Search for GitLab projects

  • create_repository - Create a new GitLab project

  • create_group - Create a new GitLab group or subgroup (name, path, description, visibility, and optional parent_id)

  • get_file_contents - Get the contents of a file or directory from a GitLab project

  • push_files - Push multiple files to a GitLab project in a single commit

  • create_issue - Create a new issue in a GitLab project

  • create_merge_request - Create a new merge request in a GitLab project

  • fork_repository - Fork a GitLab project to your account or specified namespace

  • create_branch - Create a new branch in a GitLab project

  • get_merge_request - Get details of a merge request with compact deployment summary, behind-count, commit addition summary, and approval summary (Either mergeRequestIid or branchName must be provided)

  • get_merge_request_diffs - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)

  • list_merge_request_diffs - List merge request diffs with pagination support (Either mergeRequestIid or branchName must be provided)

  • get_merge_request_conflicts - Get the conflicts of a merge request in a GitLab project

  • list_merge_request_changed_files - STEP 1 of code review workflow. Returns ONLY the list of changed file paths in a merge request โ€” WITHOUT diff content. Call this first to get file paths, then call get_merge_request_file_diff with multiple files in a single batched call (recommended 3-5 files per call). Supports excluded_file_patterns filtering using regex. (Either mergeRequestIid or branchName must be provided)

  • get_merge_request_file_diff - STEP 2 of code review workflow. Get diffs for one or more files from a merge request. Call list_merge_request_changed_files first, then pass them as an array to fetch diffs efficiently. Batching multiple files (recommended 3-5) is supported. (Either mergeRequestIid or branchName must be provided)

  • list_merge_request_versions - List all versions of a merge request

  • get_merge_request_version - Get a specific version of a merge request

  • get_branch_diffs - Get the changes/diffs between two branches or commits in a GitLab project

  • update_merge_request - Update a merge request (Either mergeRequestIid or branchName must be provided)

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

  • create_merge_request_thread - Create a new thread on a merge request

  • mr_discussions - List discussion items for a merge request

  • resolve_merge_request_thread - Resolve a thread on a merge request

  • update_merge_request_note - Modify an existing merge request thread note

  • create_merge_request_note - Add a new note to an existing merge request thread

  • delete_merge_request_discussion_note - Delete a discussion note on a merge request

  • update_merge_request_discussion_note - Update a discussion note on a merge request

  • create_merge_request_discussion_note - Add a new discussion note to an existing merge request thread

  • delete_merge_request_note - Delete an existing merge request note

  • get_merge_request_note - Get a specific note for a merge request

  • get_merge_request_notes - List notes for a merge request

  • get_draft_note - Get a single draft note from a merge request

  • list_draft_notes - List draft notes for a merge request

  • create_draft_note - Create a draft note for a merge request

  • update_draft_note - Update an existing draft note

  • delete_draft_note - Delete a draft note

  • publish_draft_note - Publish a single draft note

  • bulk_publish_draft_notes - Publish all draft notes for a merge request

  • list_merge_requests - List merge requests globally or in a specific GitLab project with filtering options (project_id is now optional)

  • approve_merge_request - Approve a merge request (requires appropriate permissions)

  • unapprove_merge_request - Unapprove a previously approved merge request

  • get_merge_request_approval_state - Get merge request approval details including approvers (uses approval_state when available, otherwise falls back to approvals)

  • update_issue_note - Modify an existing issue thread note

  • create_issue_note - Add a new note to an existing issue thread

  • list_issues - List issues (default: created by current user only; use scope='all' for all accessible issues)

  • my_issues - List issues assigned to the authenticated user (defaults to open issues)

  • get_issue - Get details of a specific issue in a GitLab project

  • update_issue - Update an issue in a GitLab project

  • update_issue_description_patch - Apply a patch (search/replace or unified diff) to an issue description. Reduces token usage by sending only the change instead of the full description. Supports dry_run to preview and create_note to summarize.

  • delete_issue - Delete an issue from a GitLab project

  • list_todos - List GitLab to-do items for the current user

  • mark_todo_done - Mark a GitLab to-do item as done

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

  • list_issue_links - List all issue links for a specific issue

  • list_issue_discussions - List discussions for an issue in a GitLab project

  • get_issue_link - Get a specific issue link

  • create_issue_link - Create an issue link between two issues

  • delete_issue_link - Delete an issue link

  • list_namespaces - List all namespaces available to the current user

  • get_namespace - Get details of a namespace by ID or path

  • verify_namespace - Verify if a namespace path exists

  • get_project - Get details of a specific project

  • list_projects - List projects accessible by the current user

  • list_project_members - List members of a GitLab project

  • list_group_projects - List projects in a GitLab group with filtering options

  • list_group_iterations - List group iterations with filtering options

  • list_labels - List labels for a project

  • get_label - Get a single label from a project

  • create_label - Create a new label in a project

  • update_label - Update an existing label in a project

  • delete_label - Delete a label from a project

  • list_pipelines - List pipelines in a GitLab project with filtering options

  • get_pipeline - Get details of a specific pipeline in a GitLab project

  • list_pipeline_jobs - List all jobs in a specific pipeline

  • list_pipeline_trigger_jobs - List all trigger jobs (bridges) in a specific pipeline that trigger downstream pipelines

  • get_pipeline_job - Get details of a GitLab pipeline job number

  • get_pipeline_job_output - Get the output/trace of a GitLab pipeline job with optional pagination to limit context window usage

  • validate_ci_lint - Validate provided GitLab CI/CD YAML content for a project

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

  • create_pipeline - Create a new pipeline for a branch or tag

  • retry_pipeline - Retry a failed or canceled pipeline

  • cancel_pipeline - Cancel a running pipeline

  • play_pipeline_job - Run a manual pipeline job

  • retry_pipeline_job - Retry a failed or canceled pipeline job

  • cancel_pipeline_job - Cancel a running pipeline job

  • list_deployments - List deployments in a GitLab project with filtering options

  • get_deployment - Get details of a specific deployment in a GitLab project

  • list_environments - List environments in a GitLab project

  • get_environment - Get details of a specific environment in a GitLab project

  • list_job_artifacts - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes

  • download_job_artifacts - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path

  • get_job_artifact_file - Get the content of a single file from a job's artifacts by its path within the archive

  • list_milestones - List milestones in a GitLab project with filtering options

  • get_milestone - Get details of a specific milestone

  • create_milestone - Create a new milestone in a GitLab project

  • edit_milestone - Edit an existing milestone in a GitLab project

  • delete_milestone - Delete a milestone from a GitLab project

  • get_milestone_issue - Get issues associated with a specific milestone

  • get_milestone_merge_requests - Get merge requests associated with a specific milestone

  • promote_milestone - Promote a milestone to the next stage

  • get_milestone_burndown_events - Get burndown events for a specific milestone

  • list_wiki_pages - List wiki pages in a GitLab project

  • get_wiki_page - Get details of a specific wiki page

  • create_wiki_page - Create a new wiki page in a GitLab project

  • update_wiki_page - Update an existing wiki page in a GitLab project

  • delete_wiki_page - Delete a wiki page from a GitLab project

  • list_group_wiki_pages - List wiki pages in a GitLab group

  • get_group_wiki_page - Get details of a specific group wiki page

  • create_group_wiki_page - Create a new wiki page in a GitLab group

  • update_group_wiki_page - Update an existing wiki page in a GitLab group

  • delete_group_wiki_page - Delete a wiki page from a GitLab group

  • get_repository_tree - Get the repository tree for a GitLab project (list files and directories)

  • list_commits - List repository commits with filtering options

  • get_commit - Get details of a specific commit

  • get_commit_diff - Get changes/diffs of a specific commit

  • list_commit_statuses - List statuses for a specific commit

  • create_commit_status - Create or update the status of a specific commit

  • list_releases - List all releases for a project

  • get_release - Get a release by tag name

  • create_release - Create a new release in a GitLab project

  • update_release - Update an existing release in a GitLab project

  • delete_release - Delete a release from a GitLab project (does not delete the associated tag)

  • create_release_evidence - Create release evidence for an existing release (GitLab Premium/Ultimate only)

  • download_release_asset - Download a release asset file by direct asset path

  • list_tags - List repository tags with filtering and pagination support

  • get_tag - Get details of a specific repository tag

  • create_tag - Create a new tag in the repository

  • delete_tag - Delete a tag from the repository

  • get_tag_signature - Get the signature of a signed tag

  • get_users - Get GitLab user details by usernames

  • list_events - List all events for the currently authenticated user

  • get_project_events - List all visible events for a specified project

  • upload_markdown - Upload a file to a GitLab project for use in markdown content

  • download_attachment - Download an uploaded file from a GitLab project by secret and filename

  • get_work_item - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets

  • list_work_items - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info

  • create_work_item - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality

  • update_work_item - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields

  • convert_work_item_type - Convert a work item to a different type (e.g. issue to task, task to incident)

  • list_work_item_statuses - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses

  • list_custom_field_definitions - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item

  • move_work_item - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation

  • list_work_item_notes - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags

  • create_work_item_note - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies

  • get_timeline_events - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags

  • create_timeline_event - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'

  • list_webhooks - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id

  • list_webhook_events - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details

  • get_webhook_event - Get full details of a specific webhook event by ID, including request/response payloads

  • search_code - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)

  • search_project_code - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)

  • search_group_code - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)

  • execute_graphql - Execute a GitLab GraphQL query

  • list_merge_request_pipelines - List pipelines for a merge request with pagination support

  • list_project_variables - List CI/CD variables for a project with optional environment scope filter

  • get_project_variable - Get a single CI/CD variable from a project by key, with optional environment scope filter

  • create_project_variable - Create a new CI/CD variable in a project

  • update_project_variable - Update an existing CI/CD variable in a project, with optional filter to disambiguate by environment scope

  • delete_project_variable - Delete a CI/CD variable from a project, with optional filter to disambiguate by environment scope

  • list_group_variables - List CI/CD variables for a group with optional environment scope filter

  • get_group_variable - Get a single CI/CD variable from a group by key, with optional environment scope filter

  • create_group_variable - Create a new CI/CD variable in a group

  • update_group_variable - Update an existing CI/CD variable in a group, with optional filter to disambiguate by environment scope

  • delete_group_variable - Delete a CI/CD variable from a group, with optional filter to disambiguate by environment scope

  • get_dependency_proxy_settings - Get dependency proxy settings for a group (enabled status, blob count, total size, image prefix, TTL policy)

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

  • list_dependency_proxy_blobs - List cached dependency proxy blobs for a group with cursor-based pagination

  • purge_dependency_proxy_cache - Schedule purge of all cached dependency proxy blobs for a group

Testing ๐Ÿงช

The project includes comprehensive test coverage including remote authorization:

Copy & paste โ€” that's it
# Run all tests (API validation + remote auth)
npm test

# Run only remote authorization tests
npm run test:remote-auth

# Run all tests including readonly MCP tests
npm run test:all

# Run only API validation
npm run test:integration

All remote authorization tests use a mock GitLab server and do not require actual GitLab credentials.