Skip to content
Cursor

GitLab MCP Server for Cursor

io.github.zereight/gitlab-mcp

GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more.

client:Cursor transport:stdio runtime:npm

Install GitLab MCP Server in Cursor

~/.cursor/mcp.json · windows: %USERPROFILE%\.cursor\mcp.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "gitlab-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_PERSONAL_ACCESS_TOKEN_FILE": "<GITLAB_PERSONAL_ACCESS_TOKEN_FILE>",
        "GITLAB_JOB_TOKEN": "<GITLAB_JOB_TOKEN>",
        "GITLAB_AUTH_COOKIE_PATH": "<GITLAB_AUTH_COOKIE_PATH>",
        "GITLAB_USE_OAUTH": "<GITLAB_USE_OAUTH>",
        "GITLAB_OAUTH_CLIENT_ID": "<GITLAB_OAUTH_CLIENT_ID>",
        "GITLAB_OAUTH_TOKEN_SCRIPT": "<GITLAB_OAUTH_TOKEN_SCRIPT>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_ALLOWED_PROJECT_IDS": "<GITLAB_ALLOWED_PROJECT_IDS>",
        "GITLAB_PERMISSION_MODE": "<GITLAB_PERMISSION_MODE>",
        "GITLAB_TOOLSETS": "<GITLAB_TOOLSETS>",
        "GITLAB_TOOLS": "<GITLAB_TOOLS>",
        "GITLAB_DENIED_TOOLS_REGEX": "<GITLAB_DENIED_TOOLS_REGEX>",
        "GITLAB_TOOL_POLICY_APPROVE": "<GITLAB_TOOL_POLICY_APPROVE>",
        "GITLAB_TOOL_POLICY_HIDDEN": "<GITLAB_TOOL_POLICY_HIDDEN>",
        "NODE_TLS_REJECT_UNAUTHORIZED": "<NODE_TLS_REJECT_UNAUTHORIZED>",
        "GITLAB_CA_CERT_PATH": "<GITLAB_CA_CERT_PATH>",
        "GITLAB_MASKING_ENABLED": "<GITLAB_MASKING_ENABLED>",
        "GITLAB_MASKING_CONFIG": "<GITLAB_MASKING_CONFIG>",
        "GITLAB_MASKING_POLICY_FILE": "<GITLAB_MASKING_POLICY_FILE>",
        "GITLAB_MASKING_WORKSPACE_DIR": "<GITLAB_MASKING_WORKSPACE_DIR>"
      }
    }
  }
}

Use .cursor/mcp.json in a project root instead to scope it to that project. Cursor merges both. Cursor docs

GitLab MCP Server in other clients