Dynamic Kanban

by renatokuipers

232 downloads Not rated yet

About

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

Explore

- Drag & Drop Interface: Move cards in browser with instant Claude synchronization
- Bulk Operations: Select and manage multiple tasks simultaneously in manual mode
- Task Management: Create, edit, delete tasks with comprehensive form validation
- Session Tracking: Development session management with time tracking
- Atomic Operations: Thread-safe state management with data integrity and backup/restore
- Auto-reconnection: Robust WebSocket connection with exponential backoff and fallback ports
- Comprehensive Validation: Pydantic models with circular dependency detection and field validation
- Real-time Notifications: Toast notifications for all operations and status changes

All tools respect the current mode (Autonomous/Manual):
- Autonomous Mode: Tools execute immediately with real-time UI updates
- Manual Mode: Claude actions are queued with detailed status messages
- Mode Switching: Queued actions can be applied or cleared when switching modes

- Task Creation: Full-featured forms with validation
- Task Editing: In-place editing with comprehensive field support
- Bulk Operations: Multi-select with bulk move and delete
- Drag & Drop: Intuitive card movement between columns

- Live Updates: Changes appear instantly across all connections
- Connection Status: Visual WebSocket connection indicators
- Activity Feed: Real-time activity log with timestamps
- Progress Tracking: Live progress bars and completion statistics

- Production Ready: Comprehensive error handling and validation
- Scalable Architecture: Modular design with separated concerns
- Data Integrity: Atomic operations with backup/restore
- Real-time Collaboration: WebSocket synchronization with conflict resolution

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Dynamic Kanban
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository


bash pip install websockets pydantic ``

- KANBAN_WEBSOCKET_PORT - WebSocket server port (default: 8765)
-
KANBAN_WEBSOCKET_HOST - WebSocket server host (default: 0.0.0.0)
-
KANBAN_RECONNECT_DELAY - Reconnection delay in milliseconds (default: 3000)
-
KANBAN_MAX_RECONNECTS` - Maximum reconnection attempts (default: 10)

pip install websockets pydantic

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "dynamic kanban": {
            "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"
                    ]
                }
            }
        }
    }
}

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"
            ]
        }
    }
}

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. Features dual-mode operation with autonomous and manual control.
Screenshot from 2025-06-23 15-16-00
Screenshot from 2025-06-23 15-15-02
Screenshot from 2025-06-23 15-15-25
Screenshot from 2025-06-23 15-14-50
Screenshot from 2025-06-23 15-15-51

Features

Core Functionality

- Real-time Collaboration: Bidirectional sync between Claude AI and HTML UI via WebSocket - Universal Project Support: Works with web apps, mobile apps, APIs, desktop software, and more - Pre-made Interface: No setup delays - open kanban-board.html and start immediately - Dual-Mode Operation: Switch between Autonomous (Claude controls) and Manual (user controls) modes - Mode Protection: Queuing system prevents conflicts when switching between control modes

Advanced Capabilities

- Drag & Drop Interface: Move cards in browser with instant Claude synchronization - Bulk Operations: Select and manage multiple tasks simultaneously in manual mode - Task Management: Create, edit, delete tasks with comprehensive form validation - Session Tracking: Development session management with time tracking - Atomic Operations: Thread-safe state management with data integrity and backup/restore - Auto-reconnection: Robust WebSocket connection with exponential backoff and fallback ports - Comprehensive Validation: Pydantic models with circular dependency detection and field validation - Real-time Notifications: Toast notifications for all operations and status changes

Quick Start

1. Install Dependencies

pip install websockets pydantic

2. Start the Server

```bash
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.