Open Kanban
MCP Server for Open kanban board
Ask AI about Open Kanban
Powered by Claude ยท Grounded in docs
I know everything about Open Kanban. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Open kanban
A collaborative kanban board built for the AI era โ empowering your AI assistants to handle tasks autonomously.
โ ๏ธ Pure Vibe Project: This project was built entirely by AI agents. The human author (songkl, skl@songkl.com) did not write a single line of code.
Highlights
๐ค AI-First Architecture
- Native MCP Integration - Out-of-the-box Model Context Protocol support
- Smart Column Config - Assign specific AI agents to designated columns
- Autonomous Workflow - AI creates, updates, moves, and comments on tasks independently
โจ Modern Collaboration
- Drag & Drop - Smooth card sorting and movement
- Real-time Sync - WebSocket-powered millisecond updates
- Multi-Board - Isolated projects with granular permissions
- Comments - In-task discussions and decisions
- Subtasks - Break down complex work
๐พ Robust Data Management
- Draft Box - Stage tasks before publishing
- Archive - Organized completion history
- File Attachments - Images, docs, and more
- SQLite/MySQL - Embedded or production-grade database
Tech Stack
| Component | Technology |
|---|---|
| Backend API | Go + Gin |
| Database | SQLite / MySQL |
| Frontend | React 19 + TypeScript |
| Styling | TailwindCSS 4 |
| Drag & Drop | dnd-kit |
| AI Protocol | MCP (Model Context Protocol) |
Quick Start
One-Command Install (Recommended)
./scripts/install.sh
This will:
- Check port availability (8080, 5173)
- Install backend/frontend/mcp-server dependencies
- Output MCP and Skill configuration templates
Manual Setup
Start Backend:
cd backend
go mod download
go run cmd/server/main.go
# Server runs on http://localhost:8080
Start Frontend:
cd frontend
npm install
npm run dev
# Visit http://localhost:5173
AI Agent Integration
One-Step Setup / ไธ้ฎๆฅๅ ฅ
Add MCP configuration to Claude Code, Cursor, or OpenCode.
ๅจ Claude CodeใCursor ๆ OpenCode ไธญๆทปๅ MCP ้ ็ฝฎใ
Claude Code / Open-Claw ้ ็ฝฎ
{
"mcpServers": {
"kanban": {
"command": "npx",
"args": ["-y", "open-kanban-mcp@latest"],
"env": {
"KANBAN_API_URL": "http://localhost:8080",
"KANBAN_MCP_TOKEN": "{YOUR_KANBAN_TOKEN}"
}
}
}
}
OpenCode ้ ็ฝฎ / OpenCode Configuration
"mcp": {
"kanban": {
"command": ["npx", "-y", "open-kanban-mcp@latest"],
"enabled": true,
"type": "local",
"environment": {
"KANBAN_API_URL": "http://localhost:8080",
"KANBAN_MCP_TOKEN": "YOUR_KANBAN_TOKEN"
}
}
}
Note / ๆณจๆ: Generate your
KANBAN_MCP_TOKENviaGET /api/auth/tokenafter logging in, or use the CLI command./kanban-server reset-password -user <nickname> -password <newpassword>to reset your password.ๅจ็ปๅฝๅ้่ฟ
GET /api/auth/token่ทๅ Token๏ผๆไฝฟ็จ CLI ๅฝไปค้็ฝฎๅฏ็ ใ
For detailed installation instructions (including OpenCode skill setup), see Installation Guide. ่ฏฆ็ปๅฎ่ฃ ๆๅ๏ผๅ ๆฌ OpenCode Skill ้ ็ฝฎ๏ผ่ฏทๆฅ็ๅฎ่ฃ ๆๆกฃใ
AI Capability Matrix
| Capability | Tools |
|---|---|
| Status | get_status |
| Board Management | list_boards, get_board |
| Column Management | list_columns, get_column |
| Task Management | create_task, update_task, delete_task, complete_task |
| Task Query | list_tasks, get_task, list_drafts, list_archived_tasks |
| Task Publishing | publish_task, archive_task |
| Collaboration | add_comment, list_comments |
| Subtasks | list_subtasks, create_subtask, update_subtask, delete_subtask |
| Dashboard | get_dashboard_stats, list_my_tasks |
Task Workflow
Todo โ In Progress โ Review โ Done โ Archived
AI agents can autonomously advance task status and record decisions via comments.
Project Structure
open-kanban/
โโโ backend/ # Go API server
โ โโโ cmd/server/ # Entry point
โ โโโ internal/
โ โโโ handlers/ # HTTP handlers
โ โโโ models/ # Data models
โ โโโ database/ # DB & migrations
โโโ frontend/ # React SPA
โ โโโ src/
โ โ โโโ components/ # Kanban components
โ โ โโโ pages/ # Route pages
โ โ โโโ services/ # API services
โ โโโ dist/ # Build output
โโโ scripts/ # Build scripts
โ โโโ build.sh # Dev build
โ โโโ release.sh # Cross-platform release
โโโ docs/ # Documentation
โ โโโ INSTALL.md # Installation guide (ไธญๆ)
โ โโโ INSTALL_EN.md # Installation guide (English)
โโโ mcp-server/ # MCP Server npm package
โโโ mcp/MCP_SETUP.md # MCP integration guide
Environment Variables
Backend
| Variable | Default | Description |
|---|---|---|
PORT | 8080 | Server port |
DB_TYPE | sqlite | sqlite or mysql |
DATABASE_URL | kanban.db | SQLite path |
DB_HOST | localhost | MySQL host |
DB_NAME | kanban | MySQL database |
MCP Server
| Variable | Default | Description |
|---|---|---|
KANBAN_API_URL | http://localhost:8080 | API URL |
KANBAN_MCP_TOKEN | - | Auth token |
Build & Release
# Dev build (current platform)
./scripts/build.sh
# Cross-platform release (macOS/Linux/Windows)
./scripts/release.sh
# Publish MCP Server to npm
cd mcp-server && npm publish
Release Output
release/
โโโ web/ # Frontend assets
โโโ kanban-server-darwin-amd64 # macOS Intel
โโโ kanban-server-darwin-arm64 # macOS Apple Silicon
โโโ kanban-server-linux-amd64 # Linux x64
โโโ kanban-server-linux-arm64 # Linux ARM
โโโ kanban-server-windows-amd64.exe # Windows
API Overview
Auth & Users
POST /api/auth/login- Login/create userGET /api/auth/me- Current user infoPOST /api/auth/token- Create API token
Boards & Columns
GET/POST /api/boards- List/create boardsGET/POST /api/columns- List/create columns
Tasks
GET/POST /api/tasks- List/create tasksPUT /api/tasks/:id- Update taskPOST /api/tasks/:id/archive- Archive task
More
GET /api/drafts- Draft listGET /api/archived- Archive listPOST /api/upload- File uploadGET /ws- WebSocket realtime
License
MIT
