gitlab-mcp-server

Alosies/gitlab-mcp-server

3.3

If you are the rightful owner of gitlab-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server that integrates with GitLab's REST API, enabling interaction with GitLab projects, issues, merge requests, and more through the MCP protocol.

Tools
5
Resources
0
Prompts
0

GitLab MCP Server

A fully typed TypeScript Model Context Protocol (MCP) server for comprehensive GitLab integration.

Quick Start

1. Get a GitLab Token

Create a GitLab Personal Access Token with api, read_user, and read_repository scopes.

2. Add to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@alosies/gitlab-mcp-server"],
      "env": {
        "NPM_CONFIG_TOKEN": "your-gitlab-token-here"
      }
    }
  }
}

3. Start Using

Ask Claude things like:

  • "List my GitLab projects"
  • "Show me open issues in myproject"
  • "Create a merge request from feature-branch to main"
  • "Get the logs for job #123"

Features

  • Projects: List, get details
  • Issues: List, get, create
  • Merge Requests: List, get, create, update
  • Pipelines: List, get, create, retry, cancel, delete
  • Jobs: List jobs, get logs with advanced trace options
  • Repository: List branches, get commits
  • User: Get current user info
  • TypeScript: Fully typed with comprehensive type definitions

Documentation

  • - Detailed installation options and setup
  • - Complete list of tools and parameters
  • - Optional configuration file setup
  • - Real-world usage examples and workflows
  • - TypeScript usage and type definitions
  • - Contributing and development setup

Self-Hosted GitLab

For self-hosted GitLab instances, add your base URL:

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@alosies/gitlab-mcp-server"],
      "env": {
        "NPM_CONFIG_TOKEN": "your-token",
        "GITLAB_BASE_URL": "https://gitlab.mycompany.com"
      }
    }
  }
}

Support

License

MIT License