gitlab-mcp
Rank #35io.github.zereight/gitlab-mcp
GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more.
gitlab-mcp is a Model Context Protocol (MCP) server published by zereight. It ranks #35 of 115,460 servers tracked on MCP Toplist, and its repository has 1,934 GitHub stars. gitlab-mcp is listed across 4 registries — Official MCP, Glama, PulseMCP and Smithery, with 22 tracked versions. It was first listed on Feb 10, 2025 and most recently updated on Aug 28, 2026.
Ranks ahead of 115,425 of 115,460 servers on MCP Toplist.
Use gitlab-mcp
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add gitlab-mcp -e "GITLAB_PERSONAL_ACCESS_TOKEN=<your GITLAB_PERSONAL_ACCESS_TOKEN>" -e "GITLAB_JOB_TOKEN=<your GITLAB_JOB_TOKEN>" -e "GITLAB_AUTH_COOKIE_PATH=<your GITLAB_AUTH_COOKIE_PATH>" -e "GITLAB_API_URL=<your GITLAB_API_URL>" -e "GITLAB_ALLOWED_PROJECT_IDS=<your GITLAB_ALLOWED_PROJECT_IDS>" -e "GITLAB_READ_ONLY_MODE=<your GITLAB_READ_ONLY_MODE>" -e "USE_GITLAB_WIKI=<your USE_GITLAB_WIKI>" -e "GITLAB_TOOLSETS=<your GITLAB_TOOLSETS>" -e "GITLAB_TOOLS=<your GITLAB_TOOLS>" -e "GITLAB_DENIED_TOOLS_REGEX=<your GITLAB_DENIED_TOOLS_REGEX>" -e "GITLAB_TOOL_POLICY_APPROVE=<your GITLAB_TOOL_POLICY_APPROVE>" -e "GITLAB_TOOL_POLICY_HIDDEN=<your GITLAB_TOOL_POLICY_HIDDEN>" -e "NODE_TLS_REJECT_UNAUTHORIZED=<your NODE_TLS_REJECT_UNAUTHORIZED>" -e "GITLAB_CA_CERT_PATH=<your GITLAB_CA_CERT_PATH>" -- npx -y @zereight/mcp-gitlabReplace each placeholder with your own value before saving.
[mcp_servers.gitlab-mcp]
command = "npx"
args = ["-y", "@zereight/mcp-gitlab"]
[mcp_servers.gitlab-mcp.env]
GITLAB_PERSONAL_ACCESS_TOKEN = "<your GITLAB_PERSONAL_ACCESS_TOKEN>"
GITLAB_JOB_TOKEN = "<your GITLAB_JOB_TOKEN>"
GITLAB_AUTH_COOKIE_PATH = "<your GITLAB_AUTH_COOKIE_PATH>"
GITLAB_API_URL = "<your GITLAB_API_URL>"
GITLAB_ALLOWED_PROJECT_IDS = "<your GITLAB_ALLOWED_PROJECT_IDS>"
GITLAB_READ_ONLY_MODE = "<your GITLAB_READ_ONLY_MODE>"
USE_GITLAB_WIKI = "<your USE_GITLAB_WIKI>"
GITLAB_TOOLSETS = "<your GITLAB_TOOLSETS>"
GITLAB_TOOLS = "<your GITLAB_TOOLS>"
GITLAB_DENIED_TOOLS_REGEX = "<your GITLAB_DENIED_TOOLS_REGEX>"
GITLAB_TOOL_POLICY_APPROVE = "<your GITLAB_TOOL_POLICY_APPROVE>"
GITLAB_TOOL_POLICY_HIDDEN = "<your GITLAB_TOOL_POLICY_HIDDEN>"
NODE_TLS_REJECT_UNAUTHORIZED = "<your NODE_TLS_REJECT_UNAUTHORIZED>"
GITLAB_CA_CERT_PATH = "<your GITLAB_CA_CERT_PATH>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gitlab-mcp": {
"command": "npx",
"args": [
"-y",
"@zereight/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<your GITLAB_PERSONAL_ACCESS_TOKEN>",
"GITLAB_JOB_TOKEN": "<your GITLAB_JOB_TOKEN>",
"GITLAB_AUTH_COOKIE_PATH": "<your GITLAB_AUTH_COOKIE_PATH>",
"GITLAB_API_URL": "<your GITLAB_API_URL>",
"GITLAB_ALLOWED_PROJECT_IDS": "<your GITLAB_ALLOWED_PROJECT_IDS>",
"GITLAB_READ_ONLY_MODE": "<your GITLAB_READ_ONLY_MODE>",
"USE_GITLAB_WIKI": "<your USE_GITLAB_WIKI>",
"GITLAB_TOOLSETS": "<your GITLAB_TOOLSETS>",
"GITLAB_TOOLS": "<your GITLAB_TOOLS>",
"GITLAB_DENIED_TOOLS_REGEX": "<your GITLAB_DENIED_TOOLS_REGEX>",
"GITLAB_TOOL_POLICY_APPROVE": "<your GITLAB_TOOL_POLICY_APPROVE>",
"GITLAB_TOOL_POLICY_HIDDEN": "<your GITLAB_TOOL_POLICY_HIDDEN>",
"NODE_TLS_REJECT_UNAUTHORIZED": "<your NODE_TLS_REJECT_UNAUTHORIZED>",
"GITLAB_CA_CERT_PATH": "<your GITLAB_CA_CERT_PATH>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gitlab-mcp": {
"command": "npx",
"args": [
"-y",
"@zereight/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<your GITLAB_PERSONAL_ACCESS_TOKEN>",
"GITLAB_JOB_TOKEN": "<your GITLAB_JOB_TOKEN>",
"GITLAB_AUTH_COOKIE_PATH": "<your GITLAB_AUTH_COOKIE_PATH>",
"GITLAB_API_URL": "<your GITLAB_API_URL>",
"GITLAB_ALLOWED_PROJECT_IDS": "<your GITLAB_ALLOWED_PROJECT_IDS>",
"GITLAB_READ_ONLY_MODE": "<your GITLAB_READ_ONLY_MODE>",
"USE_GITLAB_WIKI": "<your USE_GITLAB_WIKI>",
"GITLAB_TOOLSETS": "<your GITLAB_TOOLSETS>",
"GITLAB_TOOLS": "<your GITLAB_TOOLS>",
"GITLAB_DENIED_TOOLS_REGEX": "<your GITLAB_DENIED_TOOLS_REGEX>",
"GITLAB_TOOL_POLICY_APPROVE": "<your GITLAB_TOOL_POLICY_APPROVE>",
"GITLAB_TOOL_POLICY_HIDDEN": "<your GITLAB_TOOL_POLICY_HIDDEN>",
"NODE_TLS_REJECT_UNAUTHORIZED": "<your NODE_TLS_REJECT_UNAUTHORIZED>",
"GITLAB_CA_CERT_PATH": "<your GITLAB_CA_CERT_PATH>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"gitlab-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zereight/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<your GITLAB_PERSONAL_ACCESS_TOKEN>",
"GITLAB_JOB_TOKEN": "<your GITLAB_JOB_TOKEN>",
"GITLAB_AUTH_COOKIE_PATH": "<your GITLAB_AUTH_COOKIE_PATH>",
"GITLAB_API_URL": "<your GITLAB_API_URL>",
"GITLAB_ALLOWED_PROJECT_IDS": "<your GITLAB_ALLOWED_PROJECT_IDS>",
"GITLAB_READ_ONLY_MODE": "<your GITLAB_READ_ONLY_MODE>",
"USE_GITLAB_WIKI": "<your USE_GITLAB_WIKI>",
"GITLAB_TOOLSETS": "<your GITLAB_TOOLSETS>",
"GITLAB_TOOLS": "<your GITLAB_TOOLS>",
"GITLAB_DENIED_TOOLS_REGEX": "<your GITLAB_DENIED_TOOLS_REGEX>",
"GITLAB_TOOL_POLICY_APPROVE": "<your GITLAB_TOOL_POLICY_APPROVE>",
"GITLAB_TOOL_POLICY_HIDDEN": "<your GITLAB_TOOL_POLICY_HIDDEN>",
"NODE_TLS_REJECT_UNAUTHORIZED": "<your NODE_TLS_REJECT_UNAUTHORIZED>",
"GITLAB_CA_CERT_PATH": "<your GITLAB_CA_CERT_PATH>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gitlab-mcp": {
"command": "npx",
"args": [
"-y",
"@zereight/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<your GITLAB_PERSONAL_ACCESS_TOKEN>",
"GITLAB_JOB_TOKEN": "<your GITLAB_JOB_TOKEN>",
"GITLAB_AUTH_COOKIE_PATH": "<your GITLAB_AUTH_COOKIE_PATH>",
"GITLAB_API_URL": "<your GITLAB_API_URL>",
"GITLAB_ALLOWED_PROJECT_IDS": "<your GITLAB_ALLOWED_PROJECT_IDS>",
"GITLAB_READ_ONLY_MODE": "<your GITLAB_READ_ONLY_MODE>",
"USE_GITLAB_WIKI": "<your USE_GITLAB_WIKI>",
"GITLAB_TOOLSETS": "<your GITLAB_TOOLSETS>",
"GITLAB_TOOLS": "<your GITLAB_TOOLS>",
"GITLAB_DENIED_TOOLS_REGEX": "<your GITLAB_DENIED_TOOLS_REGEX>",
"GITLAB_TOOL_POLICY_APPROVE": "<your GITLAB_TOOL_POLICY_APPROVE>",
"GITLAB_TOOL_POLICY_HIDDEN": "<your GITLAB_TOOL_POLICY_HIDDEN>",
"NODE_TLS_REJECT_UNAUTHORIZED": "<your NODE_TLS_REJECT_UNAUTHORIZED>",
"GITLAB_CA_CERT_PATH": "<your GITLAB_CA_CERT_PATH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gitlab-mcp": {
"command": "npx",
"args": [
"-y",
"@zereight/mcp-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "<your GITLAB_PERSONAL_ACCESS_TOKEN>",
"GITLAB_JOB_TOKEN": "<your GITLAB_JOB_TOKEN>",
"GITLAB_AUTH_COOKIE_PATH": "<your GITLAB_AUTH_COOKIE_PATH>",
"GITLAB_API_URL": "<your GITLAB_API_URL>",
"GITLAB_ALLOWED_PROJECT_IDS": "<your GITLAB_ALLOWED_PROJECT_IDS>",
"GITLAB_READ_ONLY_MODE": "<your GITLAB_READ_ONLY_MODE>",
"USE_GITLAB_WIKI": "<your USE_GITLAB_WIKI>",
"GITLAB_TOOLSETS": "<your GITLAB_TOOLSETS>",
"GITLAB_TOOLS": "<your GITLAB_TOOLS>",
"GITLAB_DENIED_TOOLS_REGEX": "<your GITLAB_DENIED_TOOLS_REGEX>",
"GITLAB_TOOL_POLICY_APPROVE": "<your GITLAB_TOOL_POLICY_APPROVE>",
"GITLAB_TOOL_POLICY_HIDDEN": "<your GITLAB_TOOL_POLICY_HIDDEN>",
"NODE_TLS_REJECT_UNAUTHORIZED": "<your NODE_TLS_REJECT_UNAUTHORIZED>",
"GITLAB_CA_CERT_PATH": "<your GITLAB_CA_CERT_PATH>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.zereight%2Fgitlab-mcp)<a href="https://mcptoplist.com/server/io.github.zereight%2Fgitlab-mcp"><img src="https://mcptoplist.com/badge/io.github.zereight%2Fgitlab-mcp.svg" alt="MCP Toplist: Top 1% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 2 registries (2 delisted)
zereight
Other servers by zereight
View all zereight servers →Available versions (22)
| Version | Published |
|---|---|
| 2.1.54 | Aug 28, 2026 |
| 2.1.53 | Aug 27, 2026 |
| 2.1.50 | Aug 22, 2026 |
| 2.1.49 | Aug 18, 2026 |
| 2.1.48 | Aug 17, 2026 |
| 2.1.47 | Aug 16, 2026 |
| 2.1.46 | Aug 2, 2026 |
| 2.1.44 | Jul 29, 2026 |
| 2.1.43 | Jul 26, 2026 |
| 2.1.26 | Jun 21, 2026 |
| 2.1.25 | Jun 20, 2026 |
| 2.1.17 | May 30, 2026 |
| 2.1.13 | May 20, 2026 |
| 2.1.12 | May 17, 2026 |
| 2.1.11 | May 13, 2026 |
| 2.1.10 | May 9, 2026 |
| 2.1.9 | May 7, 2026 |
| 2.1.8 | May 5, 2026 |
| 2.1.7 | May 5, 2026 |
| 2.1.6 | May 4, 2026 |
| 2.1.5 | May 3, 2026 |
| 2.1.3 | Apr 24, 2026 |
Frequently asked questions
- Who maintains gitlab-mcp?
- gitlab-mcp is maintained by zereight, which publishes 4 MCP servers (22 total versions) tracked on MCP Toplist.
- Is gitlab-mcp listed on the Official MCP Registry?
- Yes — gitlab-mcp is listed on the Official MCP Registry, alongside Glama, PulseMCP and Smithery.
- How many versions does gitlab-mcp have?
- MCP Toplist tracks 22 versions of gitlab-mcp, most recently published on Aug 28, 2026.
- Where can I find the source code for gitlab-mcp?
- The source code for gitlab-mcp is hosted at github.com/zereight/gitlab-mcp.