prospectore/matic-home-assistant — explained in plain English
Analysis updated 2026-05-18
Control a Matic robot vacuum from Home Assistant without relying on the cloud.
Create saved cleaning plans that run rooms in a set order or clean whichever room was cleaned longest ago.
Trigger vacuum cleaning from Home Assistant automations, schedules, or scripts.
View a live map of the robot and its rooms directly on a Home Assistant dashboard.
| prospectore/matic-home-assistant | 1ncendium/aibuster | aaronmayeux/ha-hurricane-tracker | |
|---|---|---|---|
| Stars | 5 | 5 | 5 |
| Language | Python | Python | Python |
| Setup difficulty | moderate | moderate | easy |
| Complexity | 3/5 | 3/5 | 2/5 |
| Audience | general | ops devops | general |
Figures from each repo's GitHub metadata at analysis time.
Requires a Home Assistant instance with Bluetooth support and a Matic robot vacuum on the same local network.
This project is an unofficial Home Assistant integration for Matic robot vacuums. It is a community effort, not made or supported by Matic Robots Inc, and it lets you control and monitor your Matic vacuum from Home Assistant using only a local connection to the robot, without going through the cloud. Setup pairs Home Assistant with the robot over Bluetooth using the robot's own "Add another user" screen, after which day to day control, status updates, and maps flow over an encrypted local connection. Once connected, one robot shows up in Home Assistant as around 48 separate items: sensors for things like battery and current room, buttons, switches, a camera showing a live map, and the main vacuum control itself. The map is drawn from the robot's own sense of the rooms and its position, not from an actual camera image. You can start, pause, stop, or dock the robot, clean a single named room, or map Home Assistant's own room groupings onto the robot's rooms. Beyond basic control, the integration adds cleaning plans you build and save inside Home Assistant: named plans with a chosen room order and cleaning settings per room, which can either run in the same order every time or start with whichever rooms have gone longest without being cleaned. These plans can be triggered by any Home Assistant automation, schedule, or script, and the integration also lets you turn the robot's voice activation on or off from a normal switch. On privacy, the integration keeps regular traffic local and does not send any usage data, crash reports, or analytics anywhere. If you manually request a diagnostics report for troubleshooting, it leaves out anything sensitive like credentials, addresses, room maps, and Wi-Fi details. To install it you add the project as a custom repository in HACS, or copy the files into Home Assistant's custom_components folder by hand, then restart Home Assistant and complete the Bluetooth pairing prompt. It is written in Python and tested against a recent Home Assistant release, older versions have not been checked.
An unofficial Home Assistant integration that lets you control a Matic robot vacuum locally, with room cleaning plans, a live map, and automation support.
Mainly Python. The stack also includes Python, Home Assistant, Bluetooth.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.