GitHub Kanban

Provides an MCP server that manages GitHub issues in Kanban form and enables LLM-based task management, commenting, and progress visualization.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-sunwood-ai-labs_github-kanban-mcp-server": {
      "command": "github-kanban-mcp-server",
      "args": [],
      "env": {
        "GH_TOKEN": "YOUR_GH_TOKEN"
      }
    }
  }
}

You can run the GitHub Kanban MCP Server to manage GitHub issues as a Kanban board and empower a large language model to automate task management, comments, and progress visualization within an MCP client workflow.

How to use

To use the server with an MCP client, start the local MCP server process and configure the client to connect via the provided stdio interface. You will run the server as a local process and allow your MCP client to invoke its endpoints for listing issues, creating issues, updating issues, and adding comments. Your client can pass repository, issue numbers, labels, and body content, and receive structured responses that reflect the Kanban-like state of your GitHub issues. This setup enables automated task management through the LLM while keeping GitHub data in sync with your Kanban board.

Key capabilities you can leverage with your MCP client include listing issues on a board, creating new issues with emoji-prefixed titles, updating existing issues with new titles or labels, and adding comments to tasks. Ensure your client handles state transitions (open/closed) and passes the required fields shown for each operation.

How to install

Prerequisites you need before installation:

Node.js 18.x or newer
npm 9.x or newer
GitHub CLI (gh)

Install the MCP server package and authenticate the GitHub CLI to enable interaction with GitHub from the MCP server environment.

Additional setup steps

Run the following commands to install and authenticate, then prepare the MCP server for use in your client workflow.

npm install @sunwood-ai-labs/github-kanban-mcp-server
gh auth login

Available tools

list_issues

Retrieve the list of issues currently on the Kanban board for a specific repository, with filtering by state and labels.

create_issue

Create a new GitHub issue with a title (optionally starting with an emoji), body, labels, and assignees.

update_issue

Update an existing GitHub issue by changing its title, body, state, labels, and assignees.

add_comment

Add a comment to a specific GitHub issue and optionally update the issue state.