Skip to content
tempus2016 edited this page Mar 25, 2026 · 9 revisions

Welcome to the TaskMate documentation. TaskMate is a Home Assistant integration that turns household chores into a gamified reward system for children.


Quick Links

Topic Description
Installation How to install via HACS or manually
Getting Started First-time setup walkthrough
Children Managing children and avatars
Chores Creating and configuring chores
Chore Scheduling Specific days and recurring recurrence modes
Rewards Fixed costs, jackpots, and claim flow
Bonus Points Weekend multiplier, streaks, perfect week
Notifications Push notifications when chores need approval
Penalties Named point deductions for unwanted behaviour
Dashboard Cards All 13 Lovelace cards
Services All callable services with examples
Sensor Reference All entities and their attributes
Automations Example automations and notification templates
Troubleshooting Common issues and fixes

How TaskMate Works

Child completes chore → Parent approves (optional) → Points awarded
                                                           ↓
                                               Child claims reward
                                                           ↓
                                               Parent approves claim
                                                           ↓
                                                   Reward granted

All data is stored locally in Home Assistant. Nothing is sent to external services.


Key Concepts

Points — The currency children earn by completing chores. You choose the name (Stars, Coins, Bucks) and icon during setup.

Chores — Tasks assigned to one or more children. Can require parent approval before points are awarded.

Rewards — Goals children save up for. You set a fixed point cost — children work toward it at their own pace.

Streaks — How many consecutive days a child has completed at least one chore. Bonus points are awarded at configurable milestones.

Jackpot Rewards — Special rewards where all assigned children's points pool together toward a shared goal.


Version

Requires: Home Assistant 2025.1+
License: MIT

Clone this wiki locally