MCP server for GitLab API — projects, MRs, pipelines, CI/CD, approvals, issues, code review.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
mcp-gitlab
mcp-gitlab is a Model Context Protocol (MCP) server for the GitLab REST API that provides 83 tools, 7 resources, and 6 prompts for AI assistants to manage projects, merge requests, pipelines, CI/CD variables, approvals, issues, code reviews, and more. Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, and any MCP-compatible client.
Supports GitLab.com and self-hosted GitLab instances (CE/EE). No GitLab Duo or Premium required.
Built with FastMCP, httpx, and Pydantic.
Install: uvx mcp-gitlab | PyPI | MCP Registry | Changelog
1-Click Installation
💡 Tip: For other AI assistants (Claude Code, Windsurf, IntelliJ, Gemini CLI), visit the GitLab MCP Installation Gateway.
Manual Setup Guides (Click to expand)
Prerequisite: Install
uvfirst (required for alluvxinstall flows). Install uv.
Claude Code
Windsurf & IntelliJ
Windsurf: Add to ~/.codeium/windsurf/mcp_config.json
IntelliJ: Add to Settings | Tools | MCP Servers
Note: The actual server config starts at
gitlabinside themcpServersobject.
Gemini CLI
pip / uv
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
GITLAB_URL | Yes | - | GitLab instance URL (e.g. https://gitlab.example.com) |
GITLAB_TOKEN | Yes | - | Authentication token (see below) |
GITLAB_READ_ONLY | No | false | Set to true to disable write operations |
GITLAB_TIMEOUT | No | 30 | Request timeout in seconds |
GITLAB_SSL_VERIFY | No | true | Set to false to skip SSL verification |
Supported Token Types
The server checks these environment variables in order — first match wins:
GITLAB_TOKENGITLAB_PATGITLAB_PERSONAL_ACCESS_TOKENGITLAB_API_TOKEN
These accept any of the following token types:
| Token Type | Format | Use Case |
|---|---|---|
| Personal access token | glpat-xxx | User-level access with api scope |
| OAuth2 token | oauth-xxx | OAuth app integrations |
| CI job token | $CI_JOB_TOKEN | GitLab CI pipeline access |
Compatibility
| Client | Supported | Install Method |
|---|---|---|
| Claude Desktop | Yes | claude_desktop_config.json |
| Claude Code | Yes | claude mcp add |
| Cursor | Yes | One-click deeplink or .cursor/mcp.json |
| VS Code Copilot | Yes | One-click deeplink or .vscode/mcp.json |
| Windsurf | Yes | ~/.codeium/windsurf/mcp_config.json |
| Any MCP client | Yes | stdio or HTTP transport |
Tools (83)
| Category | Count | Tools |
|---|---|---|
| Projects | 4 | get, create, delete, update merge settings |
| Project Approvals | 10 | get/update config, CRUD approval rules (project + MR) |
| Groups | 6 | list, get, share/unshare project, share/unshare group |
| Branches | 3 | list, create, delete |
| Commits | 4 | list, get (with diff), create, compare |
| Merge Requests | 16 | list, get, create, update, merge, merge-sequence, rebase, changes, approve, unapprove, get approvals, list reviewers, list pipelines, list commits, subscribe, unsubscribe |
| MR Notes | 6 | list, add, delete, update, award emoji, remove emoji |
| MR Discussions | 4 | list, create (inline + multi-line), reply, resolve |
| Pipelines | 5 | list, get (with jobs), create, retry, cancel |
| Jobs | 4 | retry, play, cancel, get log |
| Tags | 4 | list, get, create, delete |
| Releases | 5 | list, get, create, update, delete |
| CI/CD Variables | 8 | CRUD for project variables, CRUD for group variables |
| Issues | 5 | list, get, create, update, add comment |
Full tool reference (click to expand)
Projects
| Tool | Description |
|---|---|
gitlab_get_project | Get project details |
gitlab_create_project | Create a new project |
gitlab_delete_project | Delete a project |
gitlab_update_project_merge_settings | Update merge settings |
Project Approvals
| Tool | Description |
|---|---|
gitlab_get_project_approvals | Get approval config |
gitlab_update_project_approvals | Update approval settings |
gitlab_list_project_approval_rules | List approval rules |
gitlab_create_project_approval_rule | Create approval rule |
gitlab_update_project_approval_rule | Update approval rule |
gitlab_delete_project_approval_rule | Delete approval rule |
gitlab_list_mr_approval_rules | List MR approval rules |
gitlab_create_mr_approval_rule | Create MR approval rule |
gitlab_update_mr_approval_rule | Update MR approval rule |
gitlab_delete_mr_approval_rule | Delete MR approval rule |
Groups
| Tool | Description |
|---|---|
gitlab_list_groups | List groups |
gitlab_get_group | Get group details |
gitlab_share_project_with_group | Share project with group |
gitlab_unshare_project_with_group | Unshare project from group |
gitlab_share_group_with_group | Share group with group |
gitlab_unshare_group_with_group | Unshare group from group |
Branches
| Tool | Description |
|---|---|
gitlab_list_branches | List branches |
gitlab_create_branch | Create a branch |
gitlab_delete_branch | Delete a branch |
Commits
| Tool | Description |
|---|---|
gitlab_list_commits | List commits |
gitlab_get_commit | Get commit (with optional diff) |
gitlab_create_commit | Create commit with file actions |
gitlab_compare | Compare branches/tags/commits |
Merge Requests
| Tool | Description |
|---|---|
gitlab_list_mrs | List merge requests |
gitlab_get_mr | Get MR details |
gitlab_create_mr | Create merge request |
gitlab_update_mr | Update merge request |
gitlab_merge_mr | Merge a merge request |
gitlab_merge_mr_sequence | Merge multiple MRs in order |
gitlab_rebase_mr | Rebase a merge request |
gitlab_mr_changes | Get MR file changes |
gitlab_approve_mr | Approve a merge request |
gitlab_unapprove_mr | Remove approval from a merge request |
gitlab_get_mr_approvals | Get MR approval state |
gitlab_list_mr_pipelines | List MR pipelines |
gitlab_list_mr_commits | List MR commits |
gitlab_subscribe_mr | Subscribe to MR notifications |
gitlab_unsubscribe_mr | Unsubscribe from MR notifications |
MR Notes
| Tool | Description |
|---|---|
gitlab_list_mr_notes | List MR comments |
gitlab_add_mr_note | Add comment to MR |
gitlab_delete_mr_note | Delete MR comment |
gitlab_update_mr_note | Update MR comment |
gitlab_award_emoji | Award emoji to note |
gitlab_remove_emoji | Remove emoji from note |
MR Discussions
| Tool | Description |
|---|---|
gitlab_list_mr_discussions | List discussions |
gitlab_create_mr_discussion | Create discussion (inline + multi-line) |
gitlab_reply_to_discussion | Reply to discussion |
gitlab_resolve_discussion | Resolve/unresolve discussion |
Pipelines
| Tool | Description |
|---|---|
gitlab_list_pipelines | List pipelines |
gitlab_get_pipeline | Get pipeline (with optional jobs) |
gitlab_create_pipeline | Trigger pipeline |
gitlab_retry_pipeline | Retry failed jobs |
gitlab_cancel_pipeline | Cancel pipeline |
Jobs
| Tool | Description |
|---|---|
gitlab_retry_job | Retry a job |
gitlab_play_job | Trigger manual job |
gitlab_cancel_job | Cancel a job |
gitlab_get_job_log | Get job log output |
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about MCP Gitlab
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/mcp-gitlab-2)HTML Embed
<a href="https://allmcps.com/mcp/mcp-gitlab-2"><img src="https://allmcps.com/api/badge/mcp-gitlab-2?style=directory" alt="MCP Gitlab on AllMCPs" /></a>