MCP server for GitLab CI/CD — pipelines, schedules, MRs, files. Works with any GitLab (SaaS or self-hosted).
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add gitlab-ci --env GITLAB_URL='<GITLAB_URL>' --env GITLAB_TOKEN='<GITLAB_TOKEN>' -- uvx gitlab-ci-mcp~/.codex/config.toml
[mcp_servers.gitlab-ci]
command = "uvx"
args = ["gitlab-ci-mcp"]
env = { GITLAB_URL = "<GITLAB_URL>", GITLAB_TOKEN = "<GITLAB_TOKEN>" }
# codex mcp add gitlab-ci --env GITLAB_URL='<GITLAB_URL>' --env GITLAB_TOKEN='<GITLAB_TOKEN>' -- uvx gitlab-ci-mcp~/.cursor/mcp.json
{
"mcpServers": {
"gitlab-ci": {
"command": "uvx",
"args": [
"gitlab-ci-mcp"
],
"env": {
"GITLAB_URL": "<GITLAB_URL>",
"GITLAB_TOKEN": "<GITLAB_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"gitlab-ci": {
"type": "stdio",
"command": "uvx",
"args": [
"gitlab-ci-mcp"
],
"env": {
"GITLAB_URL": "<GITLAB_URL>",
"GITLAB_TOKEN": "<GITLAB_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"gitlab-ci": {
"command": "uvx",
"args": [
"gitlab-ci-mcp"
],
"env": {
"GITLAB_URL": "<GITLAB_URL>",
"GITLAB_TOKEN": "<GITLAB_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"gitlab-ci": {
"command": "uvx",
"args": [
"gitlab-ci-mcp"
],
"env": {
"GITLAB_URL": "<GITLAB_URL>",
"GITLAB_TOKEN": "<GITLAB_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"gitlab-ci": {
"command": "uvx",
"args": [
"gitlab-ci-mcp"
],
"env": {
"GITLAB_URL": "<GITLAB_URL>",
"GITLAB_TOKEN": "<GITLAB_TOKEN>"
}
}
}
}Environment variables
GITLAB_URLGITLAB_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.