Dynamic Kanban

Name: Dynamic Kanban
Author: renatokuipers

@renatokuipers

Repository

About Dynamic Kanban

A dynamic, visual kanban board that lets you collab with Claude, and updates in realtime!

#kanban #claude-code #collaboration #realtime-visuals

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "dynamic-kanban": {
      "command": "python3",
      "args": [
        "./mcp-kanban-server.py"
      ],
      "env": {},
      "description": "Dynamic Kanban MCP Server v3.0 - Real-time project management with WebSocket sync",
      "version": "3.0.0",
      "capabilities": {
        "tools": [
          "create_project",
          "add_feature",
          "configure_board",
          "import_features",
          "kanban_status",
          "kanban_get_ready_tasks",
          "kanban_get_next_task",
          "kanban_move_card",
          "kanban_update_progress",
          "kanban_start_session",
          "kanban_end_session",
          "analyze_task_requirements",
          "validate_dependencies",
          "validate_project_dependencies",
          "get_task_details",
          "clear_kanban",
          "delete_project",
          "remove_feature",
          "remove_features",
          "clear_column",
          "reset_board"
        ],
        "features": [
          "Dynamic project creation for any project type",
          "Real-time UI generation with WebSocket sync",
          "Bidirectional sync between Claude and HTML UI",
          "Feature management with dependencies and circular dependency detection",
          "Pydantic data validation with comprehensive error handling",
          "Board configuration and customization",
          "JSON import/export for data portability",
          "Development session tracking",
          "Task analysis and implementation planning",
          "Drag & drop interface with live updates",
          "Cross-project compatibility",
          "Centralized configuration management",
          "Modular JavaScript architecture"
        ]
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Dynamic Kanban?

A production-ready Model Context Protocol (MCP) server that provides real-time kanban project management with bidirectional synchronization between Claude AI and an interactive HTML interface. It features dual-mode operation with autonomous and manual control.

How to use Dynamic Kanban?

Install dependencies (pip install websockets pydantic), then start the server (python3 mcp-kanban-server.py), and open kanban-board.html in your browser to connect via WebSocket on port 8765. Add the server to your Claude MCP configuration using the provided JSON snippet.

Key features of Dynamic Kanban

Real‑time collaboration via WebSocket between Claude AI and HTML UI
Dual‑mode operation: Autonomous (Claude controls) and Manual (user controls)
Pre‑made interactive kanban board interface, no setup delays
Drag & drop card movement with instant bidirectional sync
Comprehensive task management with Pydantic validation and dependency checking
Bulk operations, session tracking, and atomic state management with backup/restore
Robust WebSocket reconnection with exponential backoff and fallback ports

Use cases of Dynamic Kanban

Managing a software development project with Claude AI acting as project manager
Collaborating in real‑time where a human user and Claude both modify the kanban board
Tracking task progress across multiple development stages (backlog → done)
Running development sessions with time tracking, progress notes, and task completion

FAQ from Dynamic Kanban

What runtime dependencies does Dynamic Kanban require?

Python is required, along with the websockets and pydantic packages.

How does the dual-mode system work?

In Autonomous mode Claude has full control; in Manual mode the user controls the board and Claude’s actions are queued until mode is switched back.

Where does the kanban board data live?

Data is persisted in local JSON files: kanban-progress.json (board state and activity) and features.json (feature definitions).

What WebSocket port does Dynamic Kanban use?

It uses port 8765 by default, with automatic fallback to ports in the range 8765–8864 if the default is busy.

How are data integrity and conflicts handled?

The server uses Pydantic validation, atomic operations with backup/restore, circular dependency detection, and a queuing system to prevent conflicts between Claude and user actions.