How do I install Gitlab Docs?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Gitlab Docs need an API key?

No required environment variable is listed on this record.

What transport does Gitlab Docs use?

Gitlab Docs runs locally over stdio.

When was Gitlab Docs last checked?

Last checked 2026-11-10. Search and browse 2,900+ official GitLab documentation pages via MCP

Gitlab Docs MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.ozanmutlu-gitlab-docs -- npx -y gitlab-docs-mcp@1.1.21

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.ozanmutlu-gitlab-docs": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.1.21
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

GitLab Docs MCP Server

A Model Context Protocol server that provides AI assistants instant access to GitLab's official documentation.

Features

Intelligent Search - Fast, relevance-ranked search across all docs
Section Filtering - Target specific areas (CI/CD, API, Admin, etc.)
Full Content Access - Retrieve complete documentation pages
Always Up-to-Date - Automatically synced with latest GitLab docs
Universal Compatibility - Works with any MCP-compatible AI assistant

Installation

This server works with any MCP-compatible AI assistant. The Model Context Protocol allows AI assistants to connect to external tools and data sources through a standardized interface.

GitHub Copilot (VS Code)

1. Open MCP Configuration

Press ⌘+Shift+P (or Ctrl+Shift+P on Windows/Linux), type MCP: Open User Configuration, and press Enter.

2. Add to mcp.json:

{
  "servers": {
    "gitlab-docs": {
      "command": "npx",
      "args": ["-y", "gitlab-docs-mcp"]
    }
  }
}

3. Reload VS Code

Press ⌘+Shift+P (or Ctrl+Shift+P), type Developer: Reload Window, and press Enter.

Alternative: You can also manually create/edit the file at:

macOS: ~/Library/Application Support/Code/User/mcp.json
Windows: %APPDATA%\Code\User\mcp.json
Linux: ~/.config/Code/User/mcp.json

Claude Desktop

Claude Desktop is a standalone desktop application by Anthropic that supports MCP servers.

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gitlab-docs": {
      "command": "npx",
      "args": ["-y", "gitlab-docs-mcp"]
    }
  }
}

Restart Claude Desktop.

Cursor IDE

Cursor has built-in MCP support. Create or edit the MCP configuration file:

1. Create/Edit Configuration File

Project-specific: .cursor/mcp.json in your project root
Global: ~/.cursor/mcp.json in your home directory

2. Add Server Configuration:

{
  "mcpServers": {
    "gitlab-docs": {
      "command": "npx",
      "args": ["-y", "gitlab-docs-mcp"]
    }
  }
}

3. Restart Cursor

Other MCP Clients

For other MCP-compatible clients (Zed, Windsurf, etc.), configure them to run:

npx -y gitlab-docs-mcp

Refer to your client's MCP configuration documentation for the specific format required.

Usage

Once configured, simply ask your AI assistant about GitLab:

Example Conversations:

You: "How do I set up a CI/CD pipeline in GitLab?"
Assistant: [Searches GitLab docs and provides detailed pipeline configuration guide]

You: "Show me how to configure GitLab Runner on Ubuntu"
Assistant: [Retrieves GitLab Runner installation documentation]

You: "What are the GraphQL mutations for updating issues?"
Assistant: [Searches API docs and shows GraphQL mutation examples]

You: "Explain GitLab's authentication options"
Assistant: [Provides overview from authentication documentation]

The AI assistant will automatically use the GitLab Docs MCP server to search documentation and provide accurate, up-to-date answers.

Available Tools

`searchGitLabDocs`

Search across 2,900+ GitLab documentation pages with intelligent ranking.

Parameters:

query - Search terms
maxResults - Maximum results (default: 10, max: 50)
section - Filter by section: ci, api, user, admin, development

`getDocPage`

Retrieve the complete content of a specific documentation page.

Parameters:

path - Document path (e.g., "ci/yaml/_index.md")

`listDocSections`

Browse available documentation sections and their structure.

Troubleshooting

Server not responding?

Ensure Node.js 22.13+ or 24+ is installed: node --version
Restart your AI assistant/client completely
Check application logs for MCP connection errors

Documentation out of date? The server automatically uses the latest published version from npm. Simply restart your MCP client to get updates.

Contributing

Found a bug or have a feature request? Please visit the GitHub repository.

License

MIT - see LICENSE file for details.