Home / MCP / GitLab Kanban MCP Server

GitLab Kanban MCP Server

Provides MCP-backed access to GitLab Kanban board operations (list, create, update, delete tasks; add comments).

typescript

3stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "gitlab_kanban": {
            "command": "node",
            "args": [
                "path/to/gitlab-kanban-mcp-server/build/index.js"
            ],
            "env": {
                "GITLAB_TOKEN": "your_gitlab_token",
                "GITLAB_URL": "your_gitlab_url"
            }
        }
    }
}

You run a GitLab Kanban MCP Server to manage Kanban board operations directly from your MCP client. It provides a set of endpoints and tooling to list, create, update, delete tasks, and add comments on GitLab Kanban boards, enabling integrated automation and workflow orchestration for project boards.

How to use

Use this MCP server with an MCP client to perform Kanban actions on your GitLab projects. You can retrieve the current task list, create new tasks on the Kanban board, update existing tasks, remove tasks, and add comments to tasks. Your MCP client communicates with the server through the MCP protocol to execute these actions and receive results in real time.

How to install

npm install
```

```bash
# Build for production or deployment
npm run build
```

```bash
# Development with automatic rebuilds
npm run watch
```

```bash
# Run a local inspector to debug MCP traffic
npm run inspector
```

```env
GITLAB_TOKEN=your_gitlab_token
GITLAB_URL=your_gitlab_url  # default: https://gitlab.com
```

```json
{
  "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"
        }
      }
    }
  }
}

Additional configuration and notes

The MCP server communicates over stdio for local execution. Ensure you provide the required environment variables when starting the server so it can authenticate with GitLab and reach the GitLab instance you specify.

Troubleshooting and tips

If you encounter connectivity or authentication issues with GitLab, verify that GITLAB_TOKEN has the correct permissions and that GITLAB_URL points to your intended GitLab instance. Check that the build output index.js exists at the path you provide in the startup command and that Node can access it.

Available tools

list_tasks

Retrieve the list of tasks from a GitLab Kanban board for a given project

create_task

Create a new task on the Kanban board with specified title, description, and metadata

update_task

Update properties of an existing Kanban task, such as status, title, or description

delete_task

Delete a task from the Kanban board

add_comment

Add a comment to a specific Kanban task to provide context or updates