Hi everyone,
I would like to introduce a Kanban adapter I developed myself.
The trigger was mundane. At home, our tasks were spread across sticky notes, two different apps and our heads. I wanted shared task management that feels like a normal Kanban board, but tied into the smart home, so that scripts or my local AI agents can create cards and work through them themselves, and so I can embed the board in my dashboard.
Since I could not find anything suitable, I set out to build a fitting adapter myself.
This is what it looks like:
[image: 1784755366262-board.png]
The features
Its own web server (default port 8095) – the UI is served directly by the adapter, no iobroker upload needed for UI updates
Multiple boards with freely configurable columns: name, order, display limit, WIP limit, flags for the "new" and "done" columns
Cards with title, Markdown description, assigned users, due date (optionally with a time), labels, colour, priority, checklist, link, location and an .ics calendar invite
Recurring tasks: daily, weekly, monthly, yearly, n-th weekday, n-th working day including public holiday calculation (uses the feiertage adapter if it is installed... sorry, only works with german holidays)
Drag & drop with mouse and touch, live sync via WebSocket
Multi-user operation without a login: user list in the instance settings, members per board, and the chips in the header act as a saved person filter
E-mail notifications through the email adapter on assignment, due date and card events, switchable individually per user and per event, optionally with an .ics appointment attached
Multilingual (de, en, fr, nl, it), date and time format configurable per instance, light/dark/automatic theme, accent colour and custom CSS
[image: 1784755384015-card-editor.png]
The board runs entirely locally inside ioBroker, which was very important to me, but it still offers inbound and outbound integration options:
REST API for boards and cards (write access protected by token)
Inbound webhooks with a separate token per integration, plus sendTo and an action state for scripts
Outbound webhooks on every event, for example towards Node-RED
Mirror states per board and per user (cardCount, overdueCount, overdueList …), ready to use in VIS or Lovelace
iframe-friendly with ?embed=1, plus a dialog that lets you click together filtered view URLs for the Lovelace webpage card or any other visualisation that can embed iframes
An example from a script that creates a card:
sendTo('kanban.0', 'addCard', {
board: 'family',
title: 'Change the ventilation filter',
due: '2026-08-01',
assignees: ['bjoern']
});
Support for narrow screens (e.g. smartphones)
On narrow screens the columns stack instead of sitting side by side, and dialogs open full screen. To move a card, press and hold it briefly; while dragging, a quick-move menu with the target columns appears.
[image: 1784755411977-mobile-drag.png]
Installation
The adapter is not (yet) in the official ioBroker repository, so installation goes directly through GitHub:
iobroker url https://github.com/bmueller77/iobroker.kanban
Or in the admin UI via Adapters → Octocat icon → custom tab → enter the URL above. Then create an instance kanban.0 and open http://<host>:8095/.
Requirements: js-controller 6.0.11 or newer, Node.js 18 or newer. E-mails need a configured email instance, and the public holiday calculation optionally uses the feiertage adapter.
As always with GitHub installations: no automatic updates, and updating works the same way.
What you should know
A few points I would rather state up front than in a later thread:
The UI works without a login. Write access has been token-protected since 0.1.1, which fends off third-party websites and scanners, but it is no substitute for network isolation. The adapter belongs on the LAN; for access from outside you should put a reverse proxy with authentication in front of it. If there is enough demand, that feature might come in a later version… ;-)
This is a first project, born out of my own needs. I have tested it extensively, but only in my own environment.
Documentation
Detailed documentation lives in the GitHub repository, organised by instance settings, board, integration and reference:
German: https://github.com/bmueller77/iobroker.kanban/blob/main/docs/de/README.md
English: https://github.com/bmueller77/iobroker.kanban/blob/main/docs/en/README.md
Release for installation (v0.2.0): https://github.com/bmueller77/iobroker.kanban/releases/tag/v0.2.0
Feedback?! – Very welcome
I would be glad if one or two of you took a look. Feedback is explicitly welcome. What are you missing, what is unclear, what behaves differently than you expected, or where has a bug crept in?
Feature requests are welcome too. Perhaps you have sensible ideas for further functionality that never occurred to me.
Note: during development I had support from Claude, above all for the translations of the UI and the documentation, as well as for testing and proofreading. I am saying so because I think it is only fair.
