TL;DR
GitLab is a Version Control MCP server that lets Claude Code, Cursor, Windsurf and any MCP-compatible AI agent gitLab API — projects, merge requests, pipelines. Install in 1 minute with mcpizy install gitlab.
GitLab
Install verified 7 toolsVersion Control
GitLab API — projects, merge requests, pipelines
Official homepageInstall GitLab
mcpizy install gitlabclaude mcp add --transport http gitlab https://gitlab.com/api/v4/mcpTools exposed
7 tools availablelist_projectsList accessible GitLab projects
list_projectsList accessible GitLab projects
Inputs
searchstringoptional
get_projectGet a project's metadata
get_projectGet a project's metadata
Inputs
project_idstringrequired
list_issuesList issues in a project
list_issuesList issues in a project
Inputs
project_idstringrequiredstatestringoptional
create_issueOpen a new issue
create_issueOpen a new issue
Inputs
project_idstringrequiredtitlestringrequired
list_merge_requestsList MRs with filters
list_merge_requestsList MRs with filters
Inputs
project_idstringrequired
create_merge_requestOpen a new MR
create_merge_requestOpen a new MR
Inputs
project_idstringrequiredtitlestringrequiredsource_branchstringrequiredtarget_branchstringrequired
get_file_contentsRead a file from a repo
get_file_contentsRead a file from a repo
Inputs
project_idstringrequiredfile_pathstringrequiredrefstringoptional
Configuration
Works identically across clients. Only the config file path differs.
Claude Code~/.claude.json
~/.claude.json{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-...",
"GITLAB_API_URL": "https://gitlab.com/api/v4"
}
}
}
}Cursor.cursor/mcp.json
.cursor/mcp.json{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-...",
"GITLAB_API_URL": "https://gitlab.com/api/v4"
}
}
}
}Windsurf~/.codeium/windsurf/mcp_config.json
~/.codeium/windsurf/mcp_config.json{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-...",
"GITLAB_API_URL": "https://gitlab.com/api/v4"
}
}
}
}Authentication setup
- 1
Create a PAT with api + read_repository scopes
Get itGITLAB_PERSONAL_ACCESS_TOKEN
What you can do with GitLab MCP
Paste any of these prompts into Claude Code, Cursor or another MCP-compatible client.
“List open merge requests assigned to me”
Uses: list_merge_requests
“Create an issue in project 1234 titled 'Flaky CI build'”
Uses: create_issue
“Show me the content of .gitlab-ci.yml from my project”
Uses: get_file_contents
Works with
More Version Control MCPs
Alternatives to GitLab
If GitLab doesn't fit your stack, these Version Control MCP servers solve similar problems.
Frequently asked questions
What is the GitLab MCP server?
GitLab is listed as an Version Control Model Context Protocol server whose documented purpose is to let an MCP-compatible agent gitLab API — projects, merge requests, pipelines. Client support, permissions and authentication remain specific to the upstream project.
How do I install GitLab MCP with Claude Code?
The fastest way is the MCPizy CLI: run `mcpizy install gitlab` and MCPizy will add the server to your `.claude.json` automatically. You can also install it manually by adding an entry under `mcpServers` in `.claude.json` with the command `claude mcp add --transport http gitlab https://gitlab.com/api/v4/mcp` and restarting Claude Code.
Does MCPizy charge to view or install GitLab MCP?
No. Reading this profile and copying its install guidance is free. Upstream software, API, account or usage costs are separate, and licence coverage should be checked from the linked source when available.
Does GitLab MCP work with Cursor and Windsurf?
The MCP standard is supported by those clients, but a specific server can still have client-specific setup or transport limits. Use the configuration shown on this page when present and verify the upstream instructions before installation.
What can I do with GitLab MCP?
Its documented purpose is to let an MCP-compatible agent gitLab API — projects, merge requests, pipelines. The exact tools, permissions and write capabilities depend on the server version and configuration shown by the upstream project.
Compare before you commit
Put this server beside an alternative, or return to the full evidence directory.
Compare MCP serversBack to directory