
GitLab Kanban
โ 3from Sunwood-ai-labs
A server for managing GitLab Kanban board operations.
๐ฅ๐ฅ๐ฅโ VerifiedFreeQuick setup
<div align="center">
<img src="assets/header.svg" alt="GitLab Kanban MCP" width="800">
<div>
<a href="README.md"><img src="https://img.shields.io/badge/english-document-white.svg" alt="EN doc"></a>
<a href="README.ja.md"><img src="https://img.shields.io/badge/ใใญใฅใกใณใ-ๆฅๆฌ่ช-white.svg" alt="JA doc"/></a>
</div>
<div>
<a href="https://gitlab.com"><img src="https://img.shields.io/badge/GitLab-FC6D26?style=for-the-badge&logo=gitlab&logoColor=white" alt="GitLab"></a>
<a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript"></a>
<a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js"></a>
<a href="https://github.com/modelcontextprotocol/sdk"><img src="https://img.shields.io/badge/MCP_SDK-0.6.0-blue?style=for-the-badge" alt="MCP SDK"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="MIT License"></a>
</div>
</div>
๐ฏ GitLab Kanban MCP Server
A Model Context Protocol server for managing GitLab Kanban board operations.
โจ Features
๐ ๏ธ Available Tools
list_tasks- Retrieve task list from project's Kanban boardcreate_task- Create a new task on the Kanban boardupdate_task- Update an existing taskdelete_task- Delete a task from the boardadd_comment- Add a comment to a task
๐๏ธ Project Structure
Copy & paste โ that's it
src/
โโโ api/
โ โโโ gitlab.ts # GitLab API client and methods
โโโ config/
โ โโโ gitlab.ts # GitLab configuration
โโโ tools/
โ โโโ handlers.ts # Tool handler implementations
โ โโโ schemas.ts # Tool schema definitions
โโโ index.ts # MCP server main entry point๐ Debugging
Since MCP servers communicate over stdio, we recommend using the MCP Inspector:
Copy & paste โ that's it
npm run inspector๐ค Contributing
- Fork this repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'โจ feat: Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Create a Pull Request
๐ License
This project is licensed under the MIT License.
Copy & paste โ that's it
npm installBefore it works, you'll need: GITLAB_TOKENGITLAB_URL
๐ Getting Started
๐ฆ Installation
Copy & paste โ that's it
npm install๐ง Configuration
Create a .env file with the following environment variables:
Copy & paste โ that's it
GITLAB_TOKEN=your_gitlab_token
GITLAB_URL=your_gitlab_url # default: https://gitlab.com๐ ๏ธ Build
Copy & paste โ that's it
npm run buildFor development with auto-rebuild:
Copy & paste โ that's it
npm run watch๐ Usage
Cline Configuration
Add the following to your cline_mcp_settings.json:
Copy & paste โ that's it
{
"mcpServers": {
"gitlab-kanban-mcp-server": {
"command": "node",
"args": ["path/to/gitlab-kanban-mcp-server/build/index.js"],
"env": {
"GITLAB_TOKEN": "your_gitlab_token",
"GITLAB_URL": "your_gitlab_url"
}
}
}
}No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.