mcp-gitlab-server

GitLab MCP Server

The most comprehensive Model Context Protocol (MCP) server for GitLab — 86 tools, enterprise-ready, actively maintained.

🏆 Why Choose This GitLab MCP?

86 Tools — The Most Comprehensive GitLab MCP Available

Feature	yoda-digital/mcp-gitlab-server ⭐	zerefel/gitlab-mcp 1023★	rifqi96/mcp-gitlab 18★	HainanZhao/mcp-gitlab-jira 9★
Total Tools	86	~15	~12	~20
npm Package	✅ Published	❌ Source only	❌ Source only	❌ Source only
CI/CD Pipelines	✅ Full management	⚠️ Basic	❌ Missing	⚠️ Basic
Wiki Management	✅ Project + Group	❌ Missing	❌ Missing	❌ Missing
Member Management	✅ Project + Group	❌ Missing	❌ Missing	❌ Missing
Protected Branches	✅ Full CRUD	❌ Missing	❌ Missing	❌ Missing
Labels & Milestones	✅ Complete CRUD	⚠️ Limited	⚠️ Limited	⚠️ Limited
Group Operations	✅ Full coverage	⚠️ Basic	❌ Missing	❌ Missing
Releases	✅ Full management	❌ Missing	❌ Missing	❌ Missing
SSE Transport	✅ Supported	❌ stdio only	❌ stdio only	❌ stdio only
Read-Only Mode	✅ Built-in	❌ Missing	❌ Missing	❌ Missing
Active Maintenance	✅ Feb 2026	⚠️ Irregular	⚠️ Irregular	⚠️ Irregular
Jira Integration	🗓️ Roadmap	❌ Missing	❌ Missing	✅ Basic

See Full Product Vision & Roadmap

✨ Key Features

🔧 Comprehensive GitLab Integration (86 Tools)

Repository Management — Search, create, fork, archive repositories
File Operations — Read, create, update, delete files with full branch support
Branch Management — Create, list, delete branches
Issue Tracking — Create, list, filter, close issues with advanced search
Merge Requests — Full MR lifecycle: create, review, approve, merge
CI/CD Pipelines — List, trigger, retry, cancel pipelines + job logs
Wiki Management — Create, update wikis with attachment support (project + group)
Member Management — List and manage project/group members
Group Operations — List projects, members, manage group resources
Activity Tracking — Monitor events, commit history, project activity
Labels & Milestones — Full label and milestone management
Protected Branches — Configure branch protection rules
Releases — Create and manage project releases

Full Tool List →

🚀 Production-Ready Features

Both Transports — stdio + Server-Sent Events (SSE)
Consistent API — Standardized pagination and response formatting
Strong Typing — Built with MCP SDK for type safety
Read-Only Mode — Safe exploration without write access
Error Handling — Comprehensive error messages and validation

📦 Quick Start

Installation

From npm (Recommended)

npm install @yoda.digital/gitlab-mcp-server

From Source

git clone https://github.com/yoda-digital/mcp-gitlab-server.git
cd mcp-gitlab-server
npm install
npm run build

Configuration

For Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@yoda.digital/gitlab-mcp-server"],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "your-token-here",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

Note: The recommended approach is via npx (no install needed). If you cloned from source or installed globally, use node with the path to your built dist/index.js:
"args": ["node_modules/@yoda.digital/gitlab-mcp-server/dist/index.js"]

For Cursor IDE

See our Cursor Integration Guide for step-by-step setup.

Environment Variables

GITLAB_PERSONAL_ACCESS_TOKEN — Your GitLab PAT (required)
GITLAB_API_URL — GitLab API URL (default: https://gitlab.com/api/v4)
GITLAB_READ_ONLY — Set to true for read-only mode (optional)

🎯 Use Cases

AI-Assisted Development — Let AI create MRs, manage issues, trigger CI/CD
Automated Workflows — Build GitLab automation with natural language
Code Review — AI-powered MR descriptions and review assistance
Project Management — Manage issues, milestones, and team members via AI
CI/CD Orchestration — Monitor and control pipelines through conversational interface
Documentation — Auto-generate changelogs, update wikis, manage releases

📚 Documentation

Product Vision & Roadmap — Strategic direction and milestones
Full Tool Reference — All 60+ tools with examples
Cursor Integration — IDE setup guide
AI Tools Guide — MR description generator & more
Contributing — How to contribute
Changelog — Release history

🗺️ Roadmap

v0.3.1 (Feb 15, 2026) — Documentation & Stability

Expanded API documentation
README competitive positioning ✅
Bug fixes and stability improvements

v0.4.0 (Mar 1, 2026) — Revolutionary Feature

Jira Sync or Changelog Auto-Gen or CI Visualization
Feature no other GitLab MCP has

v0.5.0 (Mar 31, 2026) — Enterprise Ready

SAML/OAuth3 authentication
Audit logging & compliance
High-availability deployment guide

Full roadmap & strategic vision →

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Areas we'd love help with:

Additional tool implementations
Documentation improvements
Test coverage expansion
Enterprise feature development

📄 License

MIT — see LICENSE file.

🌟 Why We're Building This

GitLab is powerful, but most AI assistants can't leverage it effectively. Existing MCP implementations are limited (10-20 tools) and lack AI features.

Our mission: Make GitLab fully accessible to AI — from basic repo operations to advanced CI/CD orchestration and enterprise workflows.

Read our full product vision →

🔗 Links

Built with ❤️ by Yoda.Digital