Verified
GitLab MCP
GitLab MCP server enabling AI assistants to interact with GitLab repositories, issues, merge requests, pipelines, and projects.
Install this MCP
Pick your client, then copy the config.
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
}
}
}
}{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
}
}
}
}{
"servers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
}
}
}
}{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
}
}
}
}# Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.gitlab] command = "npx" args = ["-y", "@modelcontextprotocol/server-gitlab"] [mcp_servers.gitlab.env] GITLAB_PERSONAL_ACCESS_TOKEN = "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
Set up with your agent
Uses the same client as above (Cursor). Paste into that agent.
Install the "GitLab MCP" MCP for Cursor in this workspace.
1. Read official install docs: https://github.com/gitlab/gitlab-mcp-server
2. Merge this JSON into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITLAB_PERSONAL_ACCESS_TOKEN (required): GitLab PAT with API scope.
4. Restart Cursor if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/gitlab.htmlInstall the "GitLab MCP" MCP for Claude Desktop in this workspace.
1. Read official install docs: https://github.com/gitlab/gitlab-mcp-server
2. Merge this JSON into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITLAB_PERSONAL_ACCESS_TOKEN (required): GitLab PAT with API scope.
4. Restart Claude Desktop if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/gitlab.htmlInstall the "GitLab MCP" MCP for VS Code in this workspace.
1. Read official install docs: https://github.com/gitlab/gitlab-mcp-server
2. Merge this JSON into .vscode/mcp.json:
{
"servers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITLAB_PERSONAL_ACCESS_TOKEN (required): GitLab PAT with API scope.
4. Restart VS Code if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/gitlab.htmlInstall the "GitLab MCP" MCP for Windsurf in this workspace.
1. Read official install docs: https://github.com/gitlab/gitlab-mcp-server
2. Merge this JSON into ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-gitlab"
],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITLAB_PERSONAL_ACCESS_TOKEN (required): GitLab PAT with API scope.
4. Restart Windsurf if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/gitlab.htmlInstall the "GitLab MCP" MCP for Codex in this workspace. 1. Read official install docs: https://github.com/gitlab/gitlab-mcp-server 2. Merge this TOML under [mcp_servers.*] into ~/.codex/config.toml (or .codex/config.toml in a trusted project): # Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.gitlab] command = "npx" args = ["-y", "@modelcontextprotocol/server-gitlab"] [mcp_servers.gitlab.env] GITLAB_PERSONAL_ACCESS_TOKEN = "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN" 3. Required environment variables / secrets (ask the user; never invent secrets): - GITLAB_PERSONAL_ACCESS_TOKEN (required): GitLab PAT with API scope. 4. Restart Codex if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets. Catalog: https://averlo.xyz/launches/gitlab.html
Try it
After install, paste one of these into your agent.
- Manage GitLab projects from AI
- Create and review merge requests
- Check CI/CD pipeline status

