GitLab Remote MCP Server
GitLab's official MCP server gives agents first-party access to repositories, merge requests, issues, pipelines and code search across gitlab.com and self-managed instances. Endpoint verified live on RemoteMCP.net (preflighted 401 OAuth challenge).
- Provider
- GitLab โ
- Categories
- ๐ ๏ธ Developer Tools & Git
ไธญๆ็ฎไป
GitLab ๅฎๆนๆ็ฎก็่ฟ็จ MCP ๆๅกๅจใGitLab ๅฎๆน MCP ๆๅกๅจ๏ผไธบไปฃ็ๆไพไปๅบใๅๅนถ่ฏทๆฑใIssueใๆตๆฐด็บฟไธไปฃ็ ๆ็ดข็็ฌฌไธๆน่ฎฟ้ฎใOAuth 2.1 ไฟๆคใ
Maintainer of GitLab? Claim or update this listing โ
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"gitlab": {
"url": "https://gitlab.com/api/v4/mcp"
}
}
}claude mcp add --transport http gitlab https://gitlab.com/api/v4/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"gitlab": {
"type": "http",
"url": "https://gitlab.com/api/v4/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://gitlab.com/api/v4/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://gitlab.com/api/v4/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"gitlab": {
"serverUrl": "https://gitlab.com/api/v4/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"gitlab": {
"url": "https://gitlab.com/api/v4/mcp"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.gitlab] url = "https://gitlab.com/api/v4/mcp"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"gitlab": {
"type": "streamableHttp",
"url": "https://gitlab.com/api/v4/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"gitlab": {
"httpUrl": "https://gitlab.com/api/v4/mcp"
}
}
}๐งฐ GitLab MCP Tools & Schema (22)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| mcp_search ~34 tok | ๐ข Read | Search GitLab projects, issues and merge requests. | โ |
| get_project ~30 tok | ๐ข Read | Get details of a GitLab project. | โ |
| list_projects ~28 tok | ๐ข Read | List GitLab projects. | โ |
| get_file_contents ~31 tok | ๐ข Read | Read a file from a repository. | โ |
| get_issue ~26 tok | ๐ข Read | Get a GitLab issue. | โ |
| list_issues ~28 tok | ๐ข Read | List issues of a project. | โ |
| create_issue ~28 tok | ๐ Write | Create a GitLab issue. | โ |
| create_issue_note ~29 tok | ๐ Write | Add a note to an issue. | โ |
| get_merge_request ~29 tok | ๐ข Read | Get a merge request. | โ |
| list_merge_requests ~32 tok | ๐ข Read | List merge requests of a project. | โ |
| create_merge_request ~30 tok | ๐ Write | Create a merge request. | โ |
| create_merge_request_note ~33 tok | ๐ Write | Add a note to a merge request. | โ |
| get_pipeline ~28 tok | ๐ข Read | Get a CI/CD pipeline. | โ |
| list_pipelines ~30 tok | ๐ข Read | List pipelines of a project. | โ |
| get_job ~26 tok | ๐ข Read | Get a pipeline job. | โ |
| get_milestone ~29 tok | ๐ข Read | Get a project milestone. | โ |
| list_milestones ~29 tok | ๐ข Read | List project milestones. | โ |
| get_commit ~25 tok | ๐ข Read | Get a commit. | โ |
| list_branches ~29 tok | ๐ข Read | List repository branches. | โ |
| create_branch ~29 tok | ๐ Write | Create a repository branch. | โ |
| list_tags ~27 tok | ๐ข Read | List repository tags. | โ |
| run_pipeline ~29 tok | ๐ Write | Trigger a CI/CD pipeline. | โ |
๐ก๏ธ Security, Quality & Context Token Audit
Every tool definition (name + description + input schema) is injected into your LLMโs context on every request โ Estimate per-call LLM token cost โ
- No prompt-injection or hidden-character anomalies detected in tool descriptions
- Streamable HTTP primary endpoint (current 2025-03-26 transport)
- OAuth 2.1 with PKCE S256 enforced
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
๐ OAuth 2.1 & Security
- Auth type
- OAuth 2.1
- Dynamic Client Registration
- โ
- PKCE S256
- โ Supported
- Protected resource metadata
- https://gitlab.com/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ GitLab MCP Endpoint Overview & Security Guide
GitLab โ Remote MCP Server
GitLab's official MCP server gives agents first-party access to repositories, merge requests, issues, pipelines and code search across gitlab.com and self-managed instances. The remote endpoint means there is nothing to install โ point your MCP client at the URL and complete the OAuth consent screen. GitLab operates and versions the server themselves, so tool coverage tracks their API surface as it ships.
Official GitLab Endpoint & Transport Architecture
- Endpoint URL:
https://gitlab.com/api/v4/mcp - Transport: Streamable HTTP
Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. GitLab does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
GitLab uses OAuth 2.1 โ the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow โ PKCE โ and simply open a browser consent screen.
All 0 cataloged tools are read-only โ GitLab cannot mutate your account data, which makes it safe to connect broadly.
Common Troubleshooting & Connection Tips
- 401 Unauthorized on connect โ that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact
WWW-Authenticatechallenge. - "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely. - Requires the
mcpOAuth scope on GitLab 18.x+.
๐ How to Connect
- Copy the GitLab endpoint URLThe remote endpoint is https://gitlab.com/api/v4/mcp.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http gitlab https://gitlab.com/api/v4/mcp. Cursor: add"gitlab": { "url": "https://gitlab.com/api/v4/mcp" }undermcpServersin ~/.cursor/mcp.json. Other clients work similarly. - Complete the OAuth consentOn first connection your client opens a GitLab consent screen in the browser. Approve it to grant access; the token is stored by the client and refreshed automatically.
- Verify with the online inspectorPaste https://gitlab.com/api/v4/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm GitLab's 0 tools respond.
โ FAQ
What is the GitLab remote MCP endpoint?
The primary endpoint is https://gitlab.com/api/v4/mcp. It is an official first-party server operated by GitLab, speaking the Streamable HTTP transport.
How do I authenticate with GitLab?
GitLab uses OAuth 2.1. When your client first connects it receives a 401 challenge, discovers the authorization server via RFC 9728 metadata, and opens a browser consent screen.
I'm getting a 401 Unauthorized from GitLab โ what's wrong?
A 401 means your client hasn't completed (or has lost) the OAuth authorization. Remove and re-add the server in your client to restart the consent flow, and check that your browser session can reach the provider's login page. If the 401 arrives without a WWW-Authenticate header, run it through our OAuth debugger to see what's missing.
Which MCP clients work with GitLab?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http gitlab https://gitlab.com/api/v4/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, Kiro (`~/.kiro/settings/mcp.json`), and Claude Desktop via the `mcp-remote` bridge.
What tools does GitLab expose?
0 tools are cataloged in this directory โ including . Use our online inspector to fetch the live tool list straight from the endpoint.
๐ Connect Guides
๐ Embed Status Badge in README
Related Servers
GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.
Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.
Claude Skills's hosted remote MCP server. ClaudeSkills.club's public MCP lets agents search and pull from a catalog of 90,000+ Agent Skills (SKILL.md) โ workflow specs, safety scores and one-line install instructions. It is public and unauthenticated โ connect and call tools immediately.
CastHTML's hosted remote MCP server. CastHTML's MCP lets Claude, Cursor and other AI agents publish generated HTML dashboards or Markdown research reports as sandboxed, shareable online links (cast_live_... API key as bearer). It authenticates with a bearer token or API key sent via the Authorization header.