Wikijs MCP Server Npm

GitLab MCP Server

 ](https://nodejs.org)


A Model Context Protocol (MCP) server that connects Claude (and other MCP clients) to a GitLab instance (self-hosted or gitlab.com). Exposes 58 tools covering projects, repositories, merge requests, issues, pipelines, releases, groups, search, and more.

• Requirements
• Installation
• Configuration
• Usage

- Run directly - Register with Claude Code

• Available Tools

- Projects - Repository - Merge Requests - Issues - Pipelines - Releases - Users \& Groups - Search - Labels, Milestones \& Members

• Project ID Format
• License

Requirements

• Node.js 20.6+ (required for the --env-file flag used by npm start)
• A GitLab Personal Access Token with the api scope

Note: Node.js 18+ can also run the server if you export GITLAB_URL and GITLAB_TOKEN manually before invoking node src/index.js.

Installation

git clone https://gitlab.chuck.prod/smith8ca/gitlab-mcp-server-npm.git
cd gitlab-mcp-server-npm
npm install

Configuration

Copy the example environment file and fill in your values:

cp .env.example .env

.env:

GITLAB_URL=https://your-gitlab.com
GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx

# Optional: request timeout in ms (default: 30000)
# GITLAB_REQUEST_TIMEOUT_MS=30000

Create a Personal Access Token at: GitLab → User Settings → Access Tokens with the api scope.

Usage

Run directly

node --env-file=.env src/index.js

The server communicates over stdio and waits silently for MCP client connections. Press Ctrl+C to stop.

Register with Claude Code

claude mcp add gitlab \
  -- node --env-file=/path/to/gitlab-mcp-server/.env \
  /path/to/gitlab-mcp-server/src/index.js

Or add manually to .claude/settings.json:

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": [
        "--env-file=/path/to/gitlab-mcp-server/.env",
        "/path/to/gitlab-mcp-server/src/index.js"
      ]
    }
  }
}

Verify the server is registered:

claude mcp list

Available Tools

Projects

Repository

Merge Requests

Issues

Pipelines

Releases

Users & Groups

Search

Labels, Milestones & Members

Project ID Format

All tools that accept a project_id support both formats:

• Numeric ID: "12345"
• Namespaced path: "group/project" or "group/subgroup/project"

License

MIT — see LICENSE.