gitlab-mcp-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

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

• 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

• npm Package
• GitHub Repository
• Report Issues
• MCP Documentation

---

Built with ❤️ by Yoda.Digital