Skip to main content
Glama
jopa79
by jopa79

kanban-mcp

Terminal-basiertes Kanban Board mit MCP-Server fuer Claude Code.

  • CLI — Alle Board-Operationen direkt im Terminal

  • TUI — Interaktive Board-Ansicht mit Tastatur-Navigation

  • MCP Server — 16 Tools fuer Claude Code Integration

  • Skills — Automatisierte Review-Tests (Playwright + VHS)

  • SQLite — Pro-Projekt Datenbank in .kanban/

Screenshots

Kanban TUI

Task Detail-Ansicht

Related MCP server: Obsidian Kanban MCP Server

Setup

# Dependencies installieren
bun install

# Board im aktuellen Verzeichnis initialisieren
bun run src/index.ts init

# Optional: Board-Name angeben
bun run src/index.ts init "Mein Projekt"

CLI Commands

# Task erstellen
kanban add "Task Titel" -d "Beschreibung" -c in-progress

# Tasks auflisten
kanban list                  # Alle Tasks
kanban list -c todo          # Nur aus Todo-Spalte

# Task verschieben / abschliessen
kanban move <id> in-progress
kanban done <id>

# Task aendern / loeschen
kanban delete <id>

# Board-Status
kanban status

# Archiv
kanban archive              # Done-Tasks archivieren
kanban restore <id>         # Wiederherstellen
kanban purge --confirm      # Archiv loeschen

TUI (Terminal UI)

kanban tui

Tastaturkuerzel:

Taste

Aktion

Pfeiltasten

Zwischen Spalten/Tasks navigieren

Enter

Task-Details anzeigen

n

Neuen Task erstellen

> / <

Task in Nachbarspalte verschieben

d

Task als Done markieren

x

Task loeschen (mit Bestaetigung)

/

Tasks nach Titel filtern

Esc

Filter aufheben / Zurueck

r

Board neu laden

?

Hilfe anzeigen

q

TUI beenden

MCP Server

Als Claude Code MCP Server registrieren (~/.claude/settings.json):

{
  "mcpServers": {
    "kanban-mcp": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "/pfad/zu/kanban-mcp/src/index.ts", "mcp"],
      "env": { "BUN_BE_BUN": "1" }
    }
  }
}

Verfuegbare MCP Tools:

Tool

Beschreibung

kanban_init

Board initialisieren

kanban_add_task

Task erstellen

kanban_add_task_checked

Task mit Duplikat-Pruefung erstellen

kanban_get_task

Task per ID abrufen

kanban_list_tasks

Tasks auflisten (mit Filtern)

kanban_move_task

Task verschieben

kanban_update_task

Task-Eigenschaften aendern

kanban_delete_task

Task loeschen

kanban_complete_task

Task abschliessen

kanban_status

Board-Uebersicht

kanban_archive_tasks

Tasks archivieren

kanban_restore_task

Archivierten Task wiederherstellen

kanban_purge_archive

Archiv permanent loeschen

kanban_archive_stats

Archiv-Statistiken

kanban_export_board

Board als JSON exportieren

kanban_import_board

Board aus JSON importieren

Skills

Im Ordner skills/ liegen Claude Code Skills die auf dem Kanban MCP aufbauen.

kanban-review-tester

Testet automatisch alle Kanban-Tasks im Status "Review". Erkennt pro Task ob ein Browser-Test (Playwright) oder Terminal-Test (VHS) noetig ist.

Features:

  • Automatische Test-Typ-Erkennung anhand von Task-Titel, Notes und Labels

  • Browser-Tests via Playwright MCP (UI, Console, Netzwerk)

  • Terminal-Tests via VHS + Bash (CLI-Befehle, Builds, Migrations)

  • Ergebnisse werden direkt in die Task-Notes geschrieben

Einrichten:

# Symlink in Claude Code Skills-Ordner
ln -s /pfad/zu/kanban-mcp/skills/kanban-review-tester ~/.claude/skills/kanban-review-tester

Ausfuehren: "teste die Reviews" oder "review testen" zu Claude sagen.

Tests

bun test

Projektstruktur

kanban-mcp/
  skills/
    kanban-review-tester/
      SKILL.md              # Review-Test Skill fuer Claude Code
  src/
    index.ts              # CLI Entry Point
    core/
      db.ts               # SQLite Setup, Migrationen
      types.ts            # TypeScript Types + Converter
      board-service.ts    # Board/Spalten-Verwaltung
      task-service.ts     # Task CRUD + Duplikat-Check
      archive-service.ts  # Archiv-Management
      similarity.ts       # Trigram/Wort-Similarity
    mcp/
      server.ts           # MCP Server (stdio)
      tools.ts            # Core MCP Tools
      tools-archive.ts    # Archiv MCP Tools
      tools-extras.ts     # Duplikat-Check, Status, Complete
      mcp-context.ts      # DB-Kontext fuer MCP
    cli/
      context.ts          # DB-Kontext fuer CLI
      formatters.ts       # Terminal-Ausgabe
      commands/            # CLI Subcommands
    tui/
      app.tsx             # Ink Root Component
      board-view.tsx      # Board-Darstellung
      task-card.tsx       # Task-Karte
      detail-view.tsx     # Task-Details
      help-view.tsx       # Hilfe-Overlay
      status-bar.tsx      # Statuszeile + Eingaben
      use-board.ts        # Custom Hook fuer Board-Daten
  tests/                  # bun:test Unit-Tests

Tech Stack

  • Bun — Runtime + Test Runner

  • TypeScript — Typsicherheit

  • bun:sqlite — Datenbank (built-in)

  • @modelcontextprotocol/sdk — MCP Server

  • commander — CLI Framework

  • ink + React — Terminal UI

  • nanoid — ID-Generierung

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jopa79/kanban-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server