Skip to content

GitLab MCP Server

Manage projects, merge requests, CI/CD pipelines, and repository data on GitLab instances.

Capabilities
Projects Merge Requests CI/CD Repository
Maintained by
GitLab
Hosting
Hosted by the vendor
Authentication
OAuth sign-in
Last checked

Beta; MCP access must be enabled for the instance or top-level group; self-managed uses https://<your-gitlab>/api/v4/mcp.

How to connect the GitLab MCP server

Pick your AI client and paste the snippet. New to this? Our guide to how MCP clients and servers fit together explains what each piece does.

Claude Code

Terminal
claude mcp add --transport http gitlab https://gitlab.com/api/v4/mcp

Then run /mcp inside Claude Code and choose Authenticate to sign in.

Full Claude Code setup guide →

Claude Desktop and claude.ai

Settings → Connectors → Add custom connector
Name: GitLab
Remote MCP server URL: https://gitlab.com/api/v4/mcp

Custom connectors need a Pro, Max, Team or Enterprise plan. On Team and Enterprise an owner adds them in admin settings.

Full Claude Desktop setup guide →

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project)
{
  "mcpServers": {
    "gitlab": {
      "url": "https://gitlab.com/api/v4/mcp"
    }
  }
}
Full Cursor setup guide →

VS Code

.vscode/mcp.json
{
  "servers": {
    "gitlab": {
      "type": "http",
      "url": "https://gitlab.com/api/v4/mcp"
    }
  }
}
Full VS Code setup guide →

ChatGPT

Business, Enterprise and Edu plans (and Pro, read-only) can add this endpoint as an app in developer mode. ChatGPT setup guide →

Frequently asked questions

What is the GitLab MCP server?

It is a Model Context Protocol (MCP) server — a small piece of software that gives AI assistants like Claude a secure, governed connection to GitLab. Manage projects, merge requests, CI/CD pipelines, and repository data on GitLab instances.

Is there an official GitLab MCP server?

Yes. The GitLab MCP server is an official integration, maintained by the vendor or the Model Context Protocol project, which makes it the safest default for business use. It is maintained by GitLab.

Is the GitLab MCP server hosted, or do I run it myself?

It is hosted. GitLab runs the endpoint at https://gitlab.com/api/v4/mcp, so there is nothing to install: you add the URL to your AI client and sign in with your GitLab account.

Do I need an API key for the GitLab MCP server?

No API key is needed for the hosted server. You sign in through GitLab's own OAuth screen, and the assistant only gets the access your account has.

What can an AI assistant actually do with GitLab?

Through this server an assistant can work with projects, merge requests, ci/cd, repository — reading from and acting on GitLab directly instead of you copy-pasting between windows. What you allow it to do is controlled by the permissions you grant.

How do I set this up for my business?

The setup section above has copy-paste config for Claude Code, Claude Desktop, Cursor and VS Code. If you want it rolled out across a team with permissions, governance and support handled, that is what Crox's Build engagement covers.

New to MCP? Start with our plain-English guide to the Model Context Protocol or see how to connect AI to your business tools without writing code .

Done-for-you integration

Want this connected to your business — with governance handled?

Crox maps your processes, connects AI to the tools you already use, and keeps it working as models change. Start with a readiness assessment or talk to us about a build.