Turn chores into a game your kids actually want to play.
A Home Assistant integration for family chore management, rewards, and streak tracking.
📖 Full documentation lives in the Wiki.
- Create chores — assign them to children, set point values and schedules
- Kids complete chores — tap the child card to tick them off, earn points, build streaks
- Parents approve — chores marked "requires approval" land in a pending queue
- Kids claim rewards — points are only deducted once a parent approves the claim
Everything is managed from the TaskMate panel in the Home Assistant sidebar, and surfaced on your dashboards through 21 Lovelace cards.
All data stays inside your Home Assistant instance. Nothing is sent to any external service.
TaskMate is a default HACS integration — no custom repository needed.
- Open HACS → search "TaskMate" → Download
- Restart Home Assistant
- Settings → Devices & Services → Add Integration → TaskMate
- Pick your points name (Stars, Coins, Bucks…) and icon — that's the whole config flow
Requires Home Assistant 2024.7+ and a current browser (Chrome, Firefox, Edge, or Safari).
For manual installation and the first-run walkthrough, see Installation and Getting Started.
Chores — flexible scheduling (specific days, recurring, rotation, first-come), difficulty tiers, dependencies, timed tasks, photo proof, swaps, vacation mode, and chores that appear or hide based on HA entity state or the weather.
Points & rewards — fixed-cost rewards with a parent approval flow, savings jars, bonuses and penalties, weekend multipliers and streak milestones, real-money allowance, shared family goals, and timed device unlocks.
Gamification — levels & XP, achievement badges, quests, challenges, unlockable avatars, celebrations, and leaderboard seasons.
Parent tooling — notifications with quiet hours and reminder escalation, multi-parent approval routing, a weekly digest, insight reports on fairness and friction, an audit log, and backup & restore.
Made for kids — Routine Mode for guided morning and bedtime flows, Pre-Reader Mode for children who can't read yet, Read Aloud to a media player, a printable fridge chart, and five card design styles including a high-contrast accessible theme.
Lovelace resources register automatically on startup. Edit your dashboard → Add Card → search "taskmate".
| For kids | For parents |
|---|---|
| Child · Rewards · Reward Progress · Points Display · Routine · Streak · Badges | Approvals · Parent Dashboard · Overview · Activity · Points · Reorder · Penalties · Bonuses · Weekly · Graph · Leaderboard · Calendar · Family Goal · Photo Gallery |
Every card takes a header_color and a card_design option. See Dashboard Cards for each card's full configuration.
| Getting Started | First-time setup walkthrough |
| Admin Panel | The management hub in the HA sidebar |
| Settings | Every configurable setting in one place |
| Dashboard Cards | All 21 Lovelace cards and their options |
| Services | Every callable service, with examples |
| Sensor Reference | All entities and their attributes |
| Automations | Bus events, blueprints, and examples |
| Voice Assistants | Ask Assist about chores and points |
| Localization | Supported languages and translating |
| Troubleshooting | Common issues and fixes |
| FAQ | Frequently asked questions |
→ Browse the full wiki — 70+ pages, one per feature.
Release notes for every version live on the Releases page.
Bug reports and feature requests are welcome in Issues; questions and ideas belong in Discussions. Pull requests are welcome — see CONTRIBUTING.md.
MIT — see LICENSE.
Originally created by vinnybad/choremander. This fork adds 21 Lovelace cards, an admin panel, a bonus points system, streak tracking, reward approval flow, a penalty system, and much more.