npm package: @sekora/gitlab-mcp
Description: @sekora/gitlab-mcp MCP server - GitLab integration for Claude Desktop
Latest version: 3.1.0

# GitLab MCP Server

A comprehensive Model Context Protocol (MCP) server that provides 72+ tools for complete GitLab integration with AI assistants like Claude.

## Quick Start

**1. Get a GitLab Token:**
- Go to GitLab → Profile Settings → Access Tokens
- Create token with `api` and `read_user` scopes
- Copy the generated token

**2. Use with Claude Code:**
```bash
claude mcp add gitlab --env GITLAB_TOKEN=your-gitlab-token --scope user -- npx @sekora/gitlab-mcp
```

**3. Add to Claude Desktop config:**
```json
{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["@sekora/gitlab-mcp"],
      "env": {
        "GITLAB_TOKEN": "your-gitlab-token"
      }
    }
  }
}
```

## Features

- **72+ GitLab Tools**: Complete coverage of GitLab's API for pipelines, jobs, issues, merge requests, and more
- **Natural Language Interface**: Use the `ask` prompt to interact with GitLab using conversational commands
- **Smart Analysis**: Specialized prompts for code review, pipeline analysis, and Terragrunt plan review
- **Real-time Monitoring**: Pipeline and job monitoring with intelligent alerts and status tracking
- **Security Scanning**: SAST, dependency, container, and license scanning integration
- **Multi-Instance Support**: Connect to multiple GitLab instances (gitlab.com, self-hosted, etc.)

## Prompts

- [/ask](./readme/prompts/ask.md) - Natural language interface for GitLab operations
- [/code-review](./readme/prompts/code-review.md) - AI-powered code review analysis
- [/commit](./readme/prompts/commit.md) - Intelligent commit workflow with pipeline monitoring
- [/job-analyzer](./readme/prompts/job-analyzer.md) - Deep analysis of CI/CD job failures
- [/pipeline-analyzer](./readme/prompts/pipeline-analyzer.md) - Comprehensive pipeline performance analysis
- [/pipeline-timing](./readme/prompts/pipeline-timing.md) - Detailed timing analysis for optimization

## Tools

### Issue Management
- [gitlab_issue_create](./readme/tools/gitlab-issue-create.md) - Create new issues with metadata
- [gitlab_issue_list](./readme/tools/gitlab-issue-list.md) - List and search issues
- [gitlab_issue_details](./readme/tools/gitlab-issue-details.md) - Get detailed issue information
- [gitlab_issue_update](./readme/tools/gitlab-issue-update.md) - Update issue properties
- [gitlab_issue_close](./readme/tools/gitlab-issue-close.md) - Close issues with resolution notes
- [gitlab_issue_link](./readme/tools/gitlab-issue-link.md) - Link issues to other issues/MRs

### Pipeline Management
- [gitlab_pipeline_status](./readme/tools/gitlab-pipeline-status.md) - Get pipeline status
- [gitlab_pipeline_list](./readme/tools/gitlab-pipeline-list.md) - List pipelines with filtering
- [gitlab_pipeline_details](./readme/tools/gitlab-pipeline-details.md) - Detailed pipeline information
- [gitlab_pipeline_jobs](./readme/tools/gitlab-pipeline-jobs.md) - List jobs in a pipeline
- [gitlab_pipeline_logs](./readme/tools/gitlab-pipeline-logs.md) - Get pipeline execution logs
- [gitlab_pipeline_retry](./readme/tools/gitlab-pipeline-retry.md) - Retry failed pipelines
- [gitlab_pipeline_cancel](./readme/tools/gitlab-pipeline-cancel.md) - Cancel running pipelines
- [gitlab_pipeline_trigger](./readme/tools/gitlab-pipeline-trigger.md) - Trigger new pipelines
- [gitlab_pipeline_metrics](./readme/tools/gitlab-pipeline-metrics.md) - Pipeline performance analytics
- [gitlab_pipeline_dashboard](./readme/tools/gitlab-pipeline-dashboard.md) - Comprehensive status dashboard

### Job Management
- [gitlab_job_status](./readme/tools/gitlab-job-status.md) - Get job status and details
- [gitlab_job_list](./readme/tools/gitlab-job-list.md) - List jobs with filtering
- [gitlab_job_logs](./readme/tools/gitlab-job-logs.md) - Get job execution logs
- [gitlab_job_trace](./readme/tools/gitlab-job-trace.md) - Real-time job trace
- [gitlab_job_retry](./readme/tools/gitlab-job-retry.md) - Retry failed jobs
- [gitlab_job_cancel](./readme/tools/gitlab-job-cancel.md) - Cancel running jobs
- [gitlab_job_play](./readme/tools/gitlab-job-play.md) - Trigger manual jobs
- [gitlab_job_artifacts](./readme/tools/gitlab-job-artifacts.md) - List and download artifacts

### Merge Request Management
- [gitlab_mr_create](./readme/tools/gitlab-mr-create.md) - Create new merge requests
- [gitlab_mr_list](./readme/tools/gitlab-mr-list.md) - List and search merge requests
- [gitlab_mr_details](./readme/tools/gitlab-mr-details.md) - Get detailed MR information
- [gitlab_mr_approve](./readme/tools/gitlab-mr-approve.md) - Approve merge requests
- [gitlab_mr_merge](./readme/tools/gitlab-mr-merge.md) - Merge approved requests
- [gitlab_mr_get_comments](./readme/tools/gitlab-mr-comments.md) - Manage review comments
- [gitlab_mr_conflicts](./readme/tools/gitlab-mr-conflicts.md) - Check merge conflicts

### Repository Management
- [gitlab_branch_list](./readme/tools/gitlab-branch-list.md) - List repository branches
- [gitlab_branch_create](./readme/tools/gitlab-branch-create.md) - Create new branches
- [gitlab_branch_compare](./readme/tools/gitlab-branch-compare.md) - Compare branches/commits
- [gitlab_file_read](./readme/tools/gitlab-file-read.md) - Read file contents
- [gitlab_file_update](./readme/tools/gitlab-file-update.md) - Update file contents
- [gitlab_commit_history](./readme/tools/gitlab-commit-history.md) - Get commit history
- [gitlab_tag_create](./readme/tools/gitlab-tag-create.md) - Create repository tags
- [gitlab_release_manage](./readme/tools/gitlab-release-manage.md) - Manage releases

### Security & Quality
- [gitlab_security_scan](./readme/tools/gitlab-security-scan.md) - Comprehensive security scanning
- [gitlab_sast_results](./readme/tools/gitlab-sast-results.md) - Static analysis security testing
- [gitlab_dependency_scan](./readme/tools/gitlab-dependency-scan.md) - Dependency vulnerability scanning
- [gitlab_container_scan](./readme/tools/gitlab-container-scan.md) - Container image security scanning
- [gitlab_license_scan](./readme/tools/gitlab-license-scan.md) - License compliance scanning
- [gitlab_code_quality](./readme/tools/gitlab-code-quality.md) - Code quality metrics

### Project Administration
- [gitlab_project_settings](./readme/tools/gitlab-project-settings.md) - View and update project settings
- [gitlab_project_members](./readme/tools/gitlab-project-members.md) - Manage project members
- [gitlab_project_analytics](./readme/tools/gitlab-project-analytics.md) - Project analytics and insights
- [gitlab_access_tokens](./readme/tools/gitlab-access-tokens.md) - Manage project access tokens
- [gitlab_deploy_keys](./readme/tools/gitlab-deploy-keys.md) - Manage SSH deploy keys
- [gitlab_project_hooks](./readme/tools/gitlab-project-hooks.md) - Manage project webhooks