Skip to content

yoda-digital/mcp-gitlab-server

Repository files navigation

GitLab MCP Server

GitLab MCP Server Logo

npm version npm downloads GitHub stars GitHub last commit License: MIT GitHub issues GitHub pull requests

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_URL": "https://gitlab.com" } } } }

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_URL — GitLab instance URL (default: https://gitlab.com)
  • 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


🗺️ 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

About

Enhanced MCP server for GitLab: group projects listing and activity tracking

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors