--- title: "Maintenance Supporter" description: "Maintenance Supporter is a Marketplace integration for Home Assistant. It has 678 installs sharing analytics, works locally and was last updated October 25, 2026." canonical: "https://vulpo.app/integrations/marketplace/iluebbe-maintenance-supporter" url: "https://vulpo.app/integrations/marketplace/iluebbe-maintenance-supporter.md" last-updated: "2026-10-26" version: "1.4" --- # Maintenance Supporter > Maintenance Supporter is a Marketplace integration for Home Assistant. It has 678 installs sharing analytics, works locally and was last updated October 25, 2026. Maintenance Supporter tracks recurring upkeep of household items such as filters, pumps, cars and appliances inside Home Assistant. Tasks can follow a time interval, including patterns like the last business day of the month, or be bound to sensor data such as runtime, counters or thresholds. Adaptive scheduling can learn real intervals from history and suggest better ones. It adds sensors, buttons, a calendar, a to-do list and an overdue binary sensor, plus actions to complete, skip, add and list tasks. Tasks can be assigned to household members, with notifications that support quiet hours, bundling and mobile action buttons. Costs, budgets with alerts, spare part stock and warranty dates are tracked, and it works locally with setup in the UI. Automatic summary of the README and code of iluebbe/maintenance\_supporter. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=iluebbe&repository=maintenance_supporter&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=iluebbe&repository=maintenance_supporter&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Works with Assist**: Brings its own voice commands to Home Assistant's Assist. - **Device triggers**: Its devices can start automations directly. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Select Template Category - **Category** - **Go back**: Return to the main menu without saving. ### Select Template - **Template** - **Go back**: Return to category selection without saving. ### Customize Template - **Object name**: A name for this maintenance object. - **Area**: The area where this object is located. - **Manufacturer**: The manufacturer of the object. - **Model**: The model name or number. - **Serial number**: The serial number of the object. - **Manual / documentation URL**: Optional link to a PDF manual, vendor page, or any URL with reference info for this object. - **Notes**: Free-form notes about the object — part numbers, procedures, settings reminders, etc. - **Go back**: Return to template selection without saving. ### Global Settings - **Default warning days before due**: Number of days before a maintenance task is due to show a warning. - **Enable notifications**: Send notifications when maintenance tasks become due. - **Notification service**: The notification service to use (e.g., notify.mobile\_app\_phone). ### Create Maintenance Object - **Object name**: A unique name for this maintenance object (e.g., 'Pool Pump', 'Car'). - **Area**: The area in your home where this object is located. - **Manufacturer**: The manufacturer of the object. - **Model**: The model name or number. - **Serial number**: The serial number of the object. - **Manual / documentation URL**: Optional link to a PDF manual, vendor page, or any URL with reference info for this object. - **Notes**: Free-form notes about the object — part numbers, procedures, settings reminders, etc. - **Installation date**: When this object was installed or purchased. - **Warranty expiry**: When the manufacturer warranty for this object expires. - **Go back**: Return to the main menu without saving. ### Add Maintenance Task - **Task name**: A descriptive name for this task (e.g., 'Filter Cleaning', 'Oil Change'). - **Maintenance type**: The category of maintenance work. - **Schedule type**: How this task should be scheduled. - **Task icon**: Optional custom icon for this task (e.g., mdi:oil, mdi:filter-variant). - **Go back**: Return to the task menu without saving. - **Reading unit (for reading tasks, e.g. kWh)** ### Time-based Schedule - **Interval**: How often this maintenance repeats, combined with the interval unit. - **Interval unit**: Unit for the interval: days, weeks, months or years. Months and years follow the calendar. - **Last performed**: When this maintenance was last performed. Leave empty if never done. - **Warning days before due**: Number of days before due date to show a warning. - **Go back**: Return to task creation without saving. - **Interval anchor**: How the next due date is calculated after completion. 'Planned' prevents schedule drift by anchoring to the original due date. ### One-time Task - **Due date**: The date this one-time task is due. - **Warning days before due**: Number of days before the due date to show a warning. - **Go back**: Return to task creation without saving. ### After setup - **Adaptive Scheduling**: Show EWA, Weibull analysis, and interval suggestions for tasks. - **Seasonal Adjustments**: Show seasonal factor charts and monthly adjustment data. - **Environmental Correlation**: Show environmental correlation (temperature, humidity) adjustments. - **Budget Tracking**: Show monthly/yearly budget tracking and alerts. - **Groups**: Show maintenance group management. - **Checklists**: Show task checklists for step-by-step completion. - **Time-of-day scheduling**: Allow tasks to become overdue at a specific time of day instead of midnight. - **Completion actions**: Per-task HA action on complete + quick-complete QR with pre-set values. - **Places**: Objects maintained at another place (a Home Assistant zone): reminders only while somebody is there, and a message on arrival. - **Allow selected users to create, edit and delete**: Off (default): only admins can modify content. On: the users selected below also get full create/edit/delete access. - **Users with full panel access**: Listed users see the full panel; everyone else sees only Complete and Skip on each task. - **Default warning days before due**: Number of days before a maintenance task is due to show a warning. - **Enable notifications**: Send notifications when maintenance tasks become due or are overdue. - **Notification service**: The notification service to use (e.g., notify.mobile\_app\_phone). - **Show sidebar panel**: Show a Maintenance Supporter panel in the sidebar. - **Decimal places for amounts**: How many decimals every amount shows — KPIs, budgets, costs in lists and reports, budget alerts. 0 = whole numbers. - **Spare parts count as spending**: When bought: a buy reminder's cost counts, parts used on a job are shown as information. When used: every completion books the parts it used, and a purchase sets the part's price instead. Applies to completions from now on. - **Battery low threshold (%)**: Fleet-wide floor: a battery at or below this level counts as low unless its Battery Notes threshold is higher. - **Battery counts as replaced above (%)**: A low battery stays counted as low until its level rises above this value or a replacement is recorded — so a level hovering around the low threshold cannot complete the fleet task again and again. - **Battery counts as low after (minutes)**: A battery must read low this long before it counts as low, so a sensor that reports a very low level for a moment and recovers by itself does not put it on the list. 0 = at once. - **Record a replacement automatically when a low battery recovers**: When a battery that was low rises above the recovery threshold, the replacement date is recorded in Battery Notes and the spare cells are taken from stock — no tap needed - **Sidebar panel title**: Custom name for the sidebar entry. Leave blank to use "Maintenance". Useful to avoid clashing with Home Assistant's built-in Maintenance dashboard. - **Shopping list to sync buy tasks into**: Automatic “buy” reminders for low parts appear in this to-do list; checking one off completes the reminder and restocks the part. Leave empty to disable. - **Default to-do lists for tasks**: While a task is due, it appears on these lists unless the task picks its own lists or none (task dialog in the panel). Checking it off there completes the task. Leave empty to disable. - **Shopping search link** - **Consumable low threshold (%)**: Defaults for new Suggested setups (percent-remaining consumables) and for fleet batteries without their own Battery Notes threshold. Existing tasks keep their value. - **Notify when due soon** - **Due soon reminder interval (hours)**: How often to repeat the due-soon reminder. Set to 0 for a single notification. - **Notify when overdue** - **Overdue reminder interval (hours)**: How often to repeat the overdue reminder. Set to 0 for a single notification. - **Notify when triggered** - **Triggered reminder interval (hours)**: How often to repeat the triggered notification. Set to 0 for a single notification. - **Enable quiet hours**: Suppress notifications during quiet hours. - **Quiet hours start** - **Quiet hours end** - **Max notifications per day**: Maximum number of notifications per day. Set to 0 for unlimited. - **Bundle notifications**: Send a single summary notification when multiple tasks need attention. - **Bundle threshold**: Minimum number of tasks to trigger a bundled notification. - **Notification title style**: What appears as the notification's TITLE. Default keeps the per-status text (e.g. 'Maintenance overdue!'). Object name / Task name help when phone notifications stack. - **Completion notifications**: Household news when a task is completed, with the reason (panel, QR / NFC scan, to-do list, voice, sensor recovery …). "Automatic only" announces just the completions nobody made on the spot — sensor recovery, shopping-list check-off, an automation's service call. - **Only fire the event, send nothing myself**: Every notification fires the event maintenance\_supporter\_notification. With this on, your automation is the whole delivery — repeat intervals, quiet hours and the daily cap still decide when the event fires. - **Show 'Complete' button**: Adds a button to mark the task as completed directly from the notification. - **Show 'Skip' button**: Adds a button to skip the current maintenance cycle from the notification. - **Show 'Snooze' button**: Adds a button to postpone the notification reminder. - **Snooze duration (hours)**: How long to postpone notifications when snooze is pressed. - **Currency**: Currency used for budget display and notifications. - **Monthly budget**: Maximum monthly maintenance spending. Set to 0 to disable. - **Yearly budget**: Maximum yearly maintenance spending. Set to 0 to disable. - **Enable budget alerts**: Send a notification when spending exceeds the alert threshold. - **Alert threshold (%)**: Percentage of budget at which to send an alert. - **Select group** - **Group name**: A name for this group (e.g., 'Spring Maintenance'). - **Description**: Optional description for this group. Texts from the code of [iluebbe/maintenance\_supporter](https://github.com/iluebbe/maintenance_supporter). ## Entities - **Binary sensors**: Overdue - **Buttons**: Complete, Skip, Reset - **Calendars**: Maintenance Schedule - **Sensors**: Overdue, Due soon, Triggered, Needs attention, OK, Document storage, Total tasks, Next due, Days until due, Parts to reorder, Batteries to replace, Maintenance cost, and 1 more - **To-do lists**: Maintenance ## Actions - **Complete Maintenance**: Mark a maintenance task as completed. Fields: Entity, Notes, Cost, Duration, Reading value, Readings, Completed by, Completed at, Via tag scan - **Reset Maintenance**: Reset the last performed date of a maintenance task. Fields: Entity, Date - **Skip Maintenance**: Skip the current maintenance cycle. Fields: Entity, Reason - **Export Data**: Export all maintenance data as JSON or YAML to maintenance\_export.json / maintenance\_export.yaml in the Home Assistant config folder, then fire maintenance\_supporter\_export\_completed with the file path. Admin only. Fields: Format, Include History - **Add Object**: Create a new maintenance object (device). Returns the new entry\_id. Fields: Name, Area, Manufacturer, Model, Serial number, Installation date, Warranty expiry, Documentation URL, Notes - **Add Task**: Add a maintenance task to an existing object. Returns the new task\_id. Fields: Object, Name, Task type, Schedule type, Interval, Interval unit, Due date, Calendar schedule, Warning (days), Enabled - **Update Task**: Update the common fields of an existing maintenance task. Only the provided fields change. Fields: Object, Task ID, Name, Task type, Schedule type, Interval, Interval unit, Due date, Schedule (calendar recurrence), Warning days - **Delete Task**: Delete a maintenance task including its history. This cannot be undone - consider archiving via the panel instead. Fields: Object, Task ID - **List Tasks**: Return a snapshot of active maintenance tasks (ids, sensor entity\_id, name, status, next due, last completion, live trigger reading with target and unit, who is responsible) for automations, scripts and voice. Supports filtering by object, status and person. Fields: Object, Status, Person - **Restock spare part**: Change a spare part's stock: new ones bought, or a correction. Give exactly one of change and new count. Fields: Spare part, Change, New count - **Use spare part**: Some of a spare part were used outside a task, such as washer fluid topped up. They come off the stock like the parts of a completion; used ones of a reusable part wait to be ready again. Nothing is booked as spending. Fields: Spare part, Quantity - **Spare part ready again**: Used ones of a reusable part are ready again (charged, sharpened, ...): from the waiting pile back to the stock. Fields: Spare part, Quantity - **Dispose of used spare parts**: Used ones of a reusable part that cannot be made ready again, such as a dead cell, leave the waiting pile without going back to the stock. Fields: Spare part, Quantity ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Document storage needs cleanup, Panel-access user no longer exists, Completion action references a deleted entity, Maintenance Supporter global configuration is missing, Lost its device link, Is linked to its own maintenance device ## From the README > Everything in your home that needs regular upkeep — filters, pumps, cars, appliances, smoke detectors — tracked in one place inside Home Assistant. Schedule by time or by real sensor data, get reminded, check things off from your phone, and keep the full history of what was done and what it cost. > > Not the same as HA's built-in Maintenance Dashboard (2026.5+). That dashboard auto-discovers low-battery devices — narrow scope, zero config. Maintenance Supporter tracks user-defined maintenance with schedules, sensor triggers, history, costs, and notifications. They pair well: HA's built-in handles batteries, this integration handles everything else. From the README of [iluebbe/maintenance\_supporter](https://github.com/iluebbe/maintenance_supporter#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Productivity and information](https://vulpo.app/integrations/category/productivity-and-information.md), Calendars and to-dos - Number: 678 installs sharing analytics; 129 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2.111.0, last updated October 25, 2026 - Domain: `maintenance_supporter` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/a6f54d6fb198ebed.webp (from iluebbe/maintenance\_supporter's README) - Screenshot: https://vulpo.app/integrations-img/599631d63effdf02.webp (from iluebbe/maintenance\_supporter's README) - Screenshot: https://vulpo.app/integrations-img/c0f67ef90d0716cc.webp (from iluebbe/maintenance\_supporter's README) In Vulpo: Button card, Calendar card, Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-26. Source: https://vulpo.app/integrations/marketplace/iluebbe-maintenance-supporter --- - HTML version of this page: https://vulpo.app/integrations/marketplace/iluebbe-maintenance-supporter - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml