GitLab MCP Server

Official GitLab MCP server connecting AI tools to GitLab's DevOps platform. Enables agents to manage projects, issues, merge requests, branches, files, CI/CD pipelines, and the GitLab Duo workflow. Supports both GitLab.com SaaS and self-managed instances with fine-grained access tokens.

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@gitlab/mcp-server"
      ],
      "env": {
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "GITLAB_URL": "<YOUR_GITLAB_URL>"
      }
    }
  }
}

{
  "type": "object",
  "required": [
    "project_id",
    "source_branch",
    "target_branch",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Merge request title"
    },
    "project_id": {
      "type": "string",
      "description": "Project ID or URL-encoded path"
    },
    "description": {
      "type": "string",
      "description": "Merge request description in Markdown"
    },
    "source_branch": {
      "type": "string",
      "description": "Source branch with changes"
    },
    "target_branch": {
      "type": "string",
      "description": "Target branch to merge into"
    }
  }
}

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "state": {
      "type": "string",
      "description": "Issue state (opened, closed, all)"
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Labels to filter by"
    },
    "project_id": {
      "type": "string",
      "description": "Project ID or URL-encoded path"
    }
  }
}

{
  "type": "object",
  "required": [
    "project_id",
    "pipeline_id"
  ],
  "properties": {
    "project_id": {
      "type": "string",
      "description": "Project ID or URL-encoded path"
    },
    "pipeline_id": {
      "type": "integer",
      "description": "Pipeline ID"
    }
  }
}