GitLab MCP Server
Developer-ready GitLab MCP server for CE and EE instances.
- Pricing
- Open source
- Runs
- Locally
- Version
- 3.2.0
- Listing updated
- 4 days ago
About GitLab MCP Server
GitLab MCP Server is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add mcp-gitlab --env GITLAB_PERSONAL_ACCESS_TOKEN='<GITLAB_PERSONAL_ACCESS_TOKEN>' -- npx -y @sumirati/mcp-gitlabAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-gitlab": {
"command": "npx",
"args": [
"-y",
"@sumirati/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-gitlab": {
"command": "npx",
"args": [
"-y",
"@sumirati/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-gitlab": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sumirati/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-gitlab": {
"command": "npx",
"args": [
"-y",
"@sumirati/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-gitlab": {
"command": "npx",
"args": [
"-y",
"@sumirati/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>"
}
}
}
}Configuration
GITLAB_PERSONAL_ACCESS_TOKENGitLab Personal Access Token with api scopeRequiredGITLAB_API_URLGitLab instance API URL (defaults to https://gitlab.com/api/v4)GITLAB_READ_ONLYEnable read-only safety mode (true/false, default: false)GITLAB_EXPOSE_ALL_TOOLSSet to true to expose all 90 catalog actions directly on ListTools instead of the 5-tool hybrid surfaceMCP_OUTPUT_FORMATDefault output format: 'markdown' (default, compact tables) or 'json'
Pricing
Open source
GitLab MCP Server FAQ
Is GitLab MCP Server free?
Yes. GitLab MCP Server is open source, so you can use and self-host it for free.
How do I add GitLab MCP Server to Claude Code?
Run this command in your terminal: claude mcp add mcp-gitlab --env GITLAB_PERSONAL_ACCESS_TOKEN='<GITLAB_PERSONAL_ACCESS_TOKEN>' -- npx -y @sumirati/mcp-gitlab
What are the best alternatives to GitLab MCP Server?
The closest alternatives to GitLab MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to GitLab MCP Server

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools