Connect Cursor to your GitLab instance with the GitLab MCP server. Plan, track, and manage issues, merge requests, and pipelines — all from within your editor.

Note: This repository is mirrored on GitHub from GitLab. Please submit all merge requests and issues on GitLab. Pull requests and issues on GitHub will not be processed.

• A GitLab.com account or a GitLab Self-Managed instance (18.3+).
• GitLab Premium or Ultimate with GitLab Duo and beta features enabled. On the Free tier? Compare plans or start a free trial to get started.

1. Install the GitLab plugin from the Cursor Marketplace.
2. Open Settings > Cursor Settings > Tools & MCP and verify the GitLab MCP server appears.
3. Save and wait for your browser to open the OAuth authorization page. If this does not happen, type mcp_auth in the Cursor chat or restart Cursor.
4. Review and approve the authorization request.

"Unverified Dynamic Application" warning: During OAuth authorization, you may see a warning that Cursor is an unverified application. This is expected — Cursor uses OAuth Dynamic Client Registration, and GitLab flags all dynamically registered apps as unverified by design. The connection is still secure. Cursor is working with GitLab's Technology Partner team to get their OAuth application pre-registered and verified, which will remove this warning for all users.

Enterprise workaround: GitLab admins can eliminate the warning for their instance by pre-registering Cursor as a trusted application. Go to Admin Area → Applications → New Application, register Cursor, and enable Trusted. This removes the warning and skips the consent screen for all users on that instance.

The plugin connects to gitlab.com by default. To use a self-managed instance instead, copy .mcp.json.self-managed.example to .mcp.json and replace https://gitlab.example.com with your instance URL:

{
  "mcpServers": {
    "GitLab": {
      "type": "http",
      "url": "https://your-gitlab-instance.com/api/v4/mcp"
    }
  }
}

The core of this plugin. The GitLab MCP server gives Cursor direct access to your GitLab data through these tools:

• gitlab-workflow — GitLab development conventions (conventional commits, issue references, small merge requests).

• gitlab-ci-author — Helps write, debug, and optimize .gitlab-ci.yml pipeline configuration.

• gitlab-assistant (GitLab Assistant) — AI agent with product management capabilities that helps with Agile planning, prioritization, delivery tracking, and stakeholder communication using the MCP server.

• create-issue — Create an issue with labels, milestone, and assignees.
• create-merge-request — Create a merge request from the current branch.
• review-merge-request — Review a merge request: summarize changes, check pipelines, and flag concerns.
• pipeline-status — Check pipeline health and drill into failed jobs.
• plan-sprint — Analyze open issues and suggest sprint scope and priorities.
• backlog-health — Assess the backlog for staleness, missing labels, and unassigned work.

Try these in Cursor chat. Prefix your prompt with /gitlab-assistant to route it to the GitLab agent:

• "/gitlab-assistant Show me all open issues labeled bug in my-group/my-project"
• "/gitlab-assistant Create an issue for the API rate limiting feature with appropriate labels"
• "/gitlab-assistant What issues are assigned to me in this project?"
• "/gitlab-assistant Summarize the open issues in milestone 3.2"

• "/gitlab-assistant Help me plan the next sprint for milestone 3.2 in my-group/my-project"
• "/gitlab-assistant Analyze the backlog health for my-group/my-project"
• "/gitlab-assistant Which open issues have no assignee or labels?"

• "/gitlab-assistant Create a merge request from my current branch to main"
• "/gitlab-assistant Review merge request !142 in my-group/my-project"
• "/gitlab-assistant What files changed in MR !89?"
• "/gitlab-assistant Show me the commits in merge request !56"

• "/gitlab-assistant What's the pipeline status for my-group/my-project?"
• "/gitlab-assistant Which jobs failed in the latest pipeline?"
• "/gitlab-assistant Retry the failed pipeline for this project"

• "/gitlab-assistant Search for issues mentioning 'authentication timeout'"
• "/gitlab-assistant Find code related to user permissions in my-group/my-project"
• "/gitlab-assistant What labels are available in this project?"

• "/gitlab-assistant Show me the comments on issue #42 in my-group/my-project"
• "/gitlab-assistant Add a comment to issue #42 summarizing the investigation"

This plugin gives you core GitLab workflows in Cursor. For AI-powered agents that can autonomously plan, analyze, create code, review merge requests, fix pipelines, and more, explore the GitLab Duo Agent Platform and the GitLab Agent Catalog.

• Planner Agent — Full work item CRUD, epic/task hierarchy, dependency analysis, estimation, and planning workflows.
• Security Analyst Agent — Vulnerability triage, risk assessment, compliance reporting, and remediation planning.
• Data Analyst Agent — GLQL queries, volume analysis, team performance metrics, and trend visualization.

• Software Development Flow — AI-generated solutions across the software development lifecycle.
• Developer Flow — Convert issues into merge requests.
• Fix CI/CD Pipeline Flow — Diagnose and fix failing pipelines.
• Code Review Flow — Automate code review with AI-native analysis.
• Convert to GitLab CI/CD Flow — Migrate legacy CI/CD to GitLab.
• Agentic SAST Vulnerability Resolution — Auto-generate merge requests to fix SAST vulnerabilities.
• SAST False Positive Detection — Identify and filter false positives in SAST findings.

• Custom agents — Build team-specific agents for your unique requirements.
• External agents — Connect third-party integrations (Claude Code, OpenAI Codex, Amazon Q, Gemini) to GitLab.

• GitLab MCP server documentation
• MCP server tools reference
• GitLab Agent Catalog
• GitLab Duo Agent Platform

See CONTRIBUTING.md for guidelines on how to contribute to this project.

MIT