gitlab-mcp
Rank #16io.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 #16 of 122,350 servers tracked on MCP Toplist, and its repository has 1,955 GitHub stars. gitlab-mcp is listed across 4 registries — Official MCP, Glama, PulseMCP and Smithery, with 50 tracked versions. It was first listed on Feb 10, 2025 and most recently updated on Sep 6, 2026.
Ranks ahead of 122,334 of 122,350 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 122,350" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 4 registries
zereight
Other servers by zereight
View all zereight servers →Available versions (50)
| Version | Published |
|---|---|
| 2.1.60 | Sep 6, 2026 |
| 2.1.59 | Sep 6, 2026 |
| 2.1.58 | Sep 3, 2026 |
| 2.1.57 | Sep 2, 2026 |
| 2.1.56 | Aug 31, 2026 |
| 2.1.55 | Aug 31, 2026 |
| 2.1.54 | Aug 28, 2026 |
| 2.1.53 | Aug 27, 2026 |
| 2.1.52 | Aug 22, 2026 |
| 2.1.51 | Aug 22, 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.42 | Jul 19, 2026 |
| 2.1.41 | Jul 19, 2026 |
| 2.1.40 | Jul 16, 2026 |
| 2.1.39 | Jul 16, 2026 |
| 2.1.38 | Jul 14, 2026 |
| 2.1.30 | Jul 5, 2026 |
| 2.1.29 | Jul 3, 2026 |
| 2.1.28 | Jun 29, 2026 |
| 2.1.27 | Jun 22, 2026 |
| 2.1.26 | Jun 21, 2026 |
| 2.1.25 | Jun 20, 2026 |
| 2.1.24 | Jun 18, 2026 |
| 2.1.23 | Jun 17, 2026 |
| 2.1.22 | Jun 15, 2026 |
| 2.1.21 | Jun 14, 2026 |
| 2.1.20 | Jun 12, 2026 |
| 2.1.19 | Jun 11, 2026 |
| 2.1.18 | May 30, 2026 |
| 2.1.17 | May 30, 2026 |
| 2.1.16 | May 25, 2026 |
| 2.1.15 | May 24, 2026 |
| 2.1.14 | May 21, 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.4 | Apr 26, 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 (50 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 50 versions of gitlab-mcp, most recently published on Sep 6, 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.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.