Chore Tracker

A Home Assistant custom integration for family task and chore management with a points-based reward system.

Features

• Create and assign chores to family members
• Track completion with a points-based reward system
• Support for recurring tasks (daily, weekly, specific days)
• Reward system with claim and approval workflow
• "Up for grabs" tasks that any family member can claim
• Custom Lovelace cards for task management
• Todo list integration for each tracked person
• Points sensors for tracking earned/spent points

Installation

HACS (Recommended)

1. Add this repository as a custom repository in HACS
2. Search for "Chore Tracker" in HACS
3. Click Install
4. Restart Home Assistant

Manual Installation

1. Download the latest release
2. Copy the custom_components/chore_tracker folder to your Home Assistant config/custom_components/ directory
3. Restart Home Assistant

Configuration

1. Go to Settings > Devices & Services
2. Click "Add Integration"
3. Search for "Chore Tracker"
4. Select the family members (person entities) to track

Entities Created

For each tracked person:

• Todo List (todo.chore_tracker_<person>) - Shows assigned tasks
• Points Sensor (sensor.chore_tracker_<person>_points) - Tracks earned points

Services

Task Management

• chore_tracker.assign_chore - Assign a chore to a person
• chore_tracker.create_task - Create a task (chore, goal, or bonus)
• chore_tracker.claim_task - Claim an up-for-grabs task
• chore_tracker.get_task - Get task details
• chore_tracker.get_all_tasks - Get all tasks with filters
• chore_tracker.get_up_for_grabs_tasks - Get available tasks

Views

• chore_tracker.get_daily_view - Get daily task view for a person
• chore_tracker.get_weekly_view - Get weekly task view for a person
• chore_tracker.get_person_summary - Get comprehensive person summary

Rewards

• chore_tracker.create_reward - Create a reward
• chore_tracker.claim_reward - Claim a reward
• chore_tracker.approve_reward - Approve a reward claim
• chore_tracker.deny_reward - Deny a reward claim
• chore_tracker.get_rewards - Get available rewards
• chore_tracker.get_reward_claims - Get reward claims

Points

• chore_tracker.adjust_points - Manually adjust points for a person

Lovelace Cards

This integration includes custom Lovelace cards:

• chore-tracker-card - Main dashboard card
• chore-tracker-task-list-card - Task list view
• chore-tracker-assign-card - Task assignment interface
• chore-tracker-reward-claim-card - Reward claiming interface
• chore-tracker-reward-approval-card - Reward approval interface

Cards are automatically registered when the integration loads.

Task Types

• Chore - Regular assigned tasks
• Goal - Personal goals
• Bonus - Optional bonus tasks for extra points

Recurrence Options

• None (one-time task)
• Daily
• Weekly
• Specific days of the week

License

This project is licensed under the MIT License.