Gitlab Mcp Server

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"
• "Comment on MR #42 in myproject"
• "Show me MRs where I'm assigned as reviewer"
• "Mark MR #15 as ready for review"
• "Get the logs for job #123"

Features

• Projects: List, get details
• Issues: List, get, create
• Merge Requests: List, get, create, update with full review workflow support
• Comments & Discussions: Create notes, threaded discussions, inline code comments
• Review Management: Resolve/unresolve discussions, mark as draft/ready
• Filtering: Filter by reviewer, assignee, author
• Templates: Use GitLab MR templates for descriptions
• 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

• [Installation Guide](docs/installation.md) - Detailed installation options and setup
• [Available Tools](docs/tools.md) - Complete list of tools and parameters
• [Configuration](docs/configuration.md) - Optional configuration file setup
• [Usage Examples](docs/examples.md) - Real-world usage examples and workflows
• [TypeScript Guide](docs/typescript.md) - TypeScript usage and type definitions
• [Development](docs/development.md) - 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

• Issues: GitHub Issues
• GitLab API: GitLab API Documentation
• MCP Protocol: Model Context Protocol

License

MIT License

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Alosies
• Source: Alosies/gitlab-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.