MCP Directory

How to add GitLab MCP Server (zereight) to Cursor

Popular community GitLab MCP server for projects, MRs, issues, pipelines, wikis and releases. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 1.7k★ · stdio · apikey

Cursor config for GitLab MCP Server (zereight)

npx -y @zereight/mcp-gitlab
{
  "mcpServers": {
    "gitlab-mcp-server-zereight": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_API_URL": "https://gitlab.com/api/v4",
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<your-gitlab-token>"
      }
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the GitLab MCP Server (zereight) config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of GitLab MCP Server (zereight)'s tools to confirm it's connected.

Before you start

  • Node.js 18 or later (or Docker to run the zereight050/gitlab-mcp image)
  • A GitLab Personal Access Token with at least the `api` scope (create it under GitLab > User Settings > Access Tokens)
  • Your GitLab API URL, e.g. https://gitlab.com/api/v4 for SaaS or your self-hosted instance URL
  • An MCP-capable client (Claude Desktop, Cursor, VS Code, etc.)

What GitLab MCP Server (zereight) can do in Cursor

create_merge_request

Create a new merge request in a project

get_merge_request_diffs

Fetch the diffs/changed files for a merge request

create_merge_request_note

Add a comment or review note to a merge request

create_issue

Create a new issue in a project

list_issues

List and filter issues in a project

update_issue

Edit or close an existing issue

list_pipelines

List CI/CD pipelines for a project

get_pipeline_job_output

Retrieve the log output of a pipeline job

Security

A GitLab PAT can read and write across all projects you can access; scope it to read_api or specific projects where possible. Point GITLAB_API_URL at your own instance and verify TLS for self-hosted setups.

GitLab MCP Server (zereight) + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the GitLab MCP Server (zereight) config there under the "mcpServers" key and restart the client.

Is GitLab MCP Server (zereight) safe to use with Cursor?

A GitLab PAT can read and write across all projects you can access; scope it to read_api or specific projects where possible. Point GITLAB_API_URL at your own instance and verify TLS for self-hosted setups.

Is this the official GitLab MCP server?

No. It is a popular community project (the @zereight/mcp-gitlab package), not maintained by GitLab Inc. It is licensed MIT.

Does it work with self-hosted GitLab?

Yes. Set `GITLAB_API_URL` to your instance's API endpoint; it works against both self-managed GitLab and gitlab.com.

What token scope do I need?

A Personal Access Token with at least the `api` scope. The token's own permissions determine which projects and actions are available to the assistant.

View repo Full GitLab MCP Server (zereight) page