The GitLab Kanban MCP Server enables management of GitLab Kanban boards via API operations. You can:
Retrieve task lists from a project's Kanban board
Create new tasks with optional labels and descriptions
Update existing tasks, including changing their state, title, or description
Delete tasks from the board
Add comments to tasks, supporting Markdown formatting
Provides tools for managing GitLab Kanban boards, including listing, creating, updating, and deleting tasks, as well as adding comments to existing tasks.
Built on Node.js runtime for executing the MCP server operations.
Uses TypeScript for type-safe implementation of the GitLab Kanban board operations.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GitLab Kanban MCP Serverlist tasks from project 'web-app' Kanban board"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ฏ 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
Related MCP server: GitHub Kanban MCP Server
๐๏ธ Project Structure
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๐ Getting Started
๐ฆ Installation
npm install๐ง Configuration
Create a .env file with the following environment variables:
GITLAB_TOKEN=your_gitlab_token
GITLAB_URL=your_gitlab_url # default: https://gitlab.com๐ ๏ธ Build
npm run buildFor development with auto-rebuild:
npm run watch๐ Debugging
Since MCP servers communicate over stdio, we recommend using the MCP Inspector:
npm run inspector๐ Usage
Cline Configuration
Add the following to your cline_mcp_settings.json:
{
"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"
}
}
}
}๐ค 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.