github-kanban

The GitHub Kanban MCP Server provides a set of tools to manage GitHub issues in a kanban-style view integrated with an LLM-driven task workflow. It exposes 4 MCP actions: list_issues to fetch issues for a repository and present them in a kanban-like list, create_issue to spawn new issues with a chosen title, body and labels, update_issue to modify existing issues (title, body, state, labels, and assignees), and add_comment to append comments to a task while optionally updating the issue state. These tools enable streamlined task management from an LLM or other MCP clients by interacting with GitHub issues as structured data.

To use them, call the corresponding tool via the MCP interface with the required inputs. For example, list_issues requires a repo, a state (open, closed, or all), and optional labels to filter by. create_issue needs repository, title, optional emoji for the title, body, and optional labels and assignees. update_issue updates an existing issue by providing issue_number along with new title/body/state/labels/assignees. add_comment requires the target repository, issue_number, a Markdown-friendly body, and an optional state change. The MCP server will translate these requests into GitHub API calls and return structured results suitable for downstream processing or UI rendering.

Prerequisites:\n- Node.js 18.x or newer\n- npm 9.x or newer\n- GitHub CLI (gh)\n\nInstall the MCP server package and set up authentication:\nbash\n# Install the MCP server package\nnpm install @sunwood-ai-labs/github-kanban-mcp-server\n\n# Authenticate with GitHub (required for GitHub API access)\ngh auth login\n\n\nConfigure MCP: create or update your MCP configuration to include the server:\njson\n{ "mcpServers": { "github-kanban": { "command": "github-kanban-mcp-server" } } }\n\n\nRun the MCP server (as defined by your MCP runner; the configuration above uses the package bin name):\nbash\n# If your environment uses a direct bin invocation from node_modules/.bin or a global bin, one common approach is:\n# npx -y @sunwood-ai-labs/github-kanban-mcp-server\n````\n\nOptional: consider adding a start script to package.json for convenience:\njson\n"scripts": {\n "start": "github-kanban-mcp-server"\n}\n```

Tips & known considerations:\n- Ensure gh CLI is authenticated to access the necessary GitHub repositories.\n- The MCP server expects the repository to be accessible by the authenticated user.\n- When filtering with labels in list_issues, pass an array of label names to refine results.\n- Emoji support in titles is purely cosmetic for UX; you may pass an emoji string via the emoji field when creating or updating issues.\n- If you modify the MCP configuration, restart the MCP server to apply changes.\n- Network access to GitHub is required; ensure any firewalls or proxies allow API access.