# GitLab Docs MCP server

> Allows AI assistants to search and retrieve content from over 2,900 official GitLab documentation pages.

- Repository: https://github.com/ozanmutlu/Gitlab-Docs-MCP
- Page: https://hostedmcp.org/servers/ozanmutlu/gitlab-docs-mcp
- Transport: stdio
- Stars: 3
- License: MIT
- Latest version: 1.1.21

## Install

### Claude Code

```sh
claude mcp add gitlab-docs-mcp -- npx -y gitlab-docs-mcp
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

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

### VS Code CLI

```sh
code --add-mcp '{"name":"gitlab-docs-mcp","type":"stdio","command":"npx","args":["-y","gitlab-docs-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add gitlab-docs-mcp -- npx -y gitlab-docs-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.gitlab-docs-mcp]
command = "npx"
args = ["-y", "gitlab-docs-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user gitlab-docs-mcp npx -- -y gitlab-docs-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (3)

- `searchGitLabDocs`: Search 2,900+ official GitLab documentation pages. Covers .gitlab-ci.yml syntax, CI/CD pipelines, runners, jobs, variables, artifacts, caching, environments, deployments, merge requests, approvals, code review, GitLab API (REST and GraphQL), container registry, package registry, Kubernetes agent, security scanning (SAST, DAST, dependency scanning, secret detection), GitLab Pages, authentication (SSO, SAML, LDAP, OAuth), permissions, admin settings, Gitaly, Sidekiq, Geo replication, and backup/restore. (read-only)
- `getDocPage`: Retrieve the full content of a GitLab documentation page by path. Returns complete configuration examples, YAML snippets, CLI commands, API request/response samples, and step-by-step setup guides. Use after searchGitLabDocs to get detailed page content. (read-only)
- `listDocSections`: Browse GitLab documentation structure including sections for CI/CD, API, administration, user guides, development, security, operations, and integrations. (read-only)

## FAQ

### How can I search for specific GitLab topics?

You can use the search tool to query across 2,900+ pages and filter by sections like CI/CD, API, or Admin.

### What are the system requirements for this server?

You must have Node.js version 22.13+ or 24+ installed on your system.

### How do I get the latest documentation updates?

The server is automatically synced; simply restart your MCP client to receive the latest updates.
