I’ve released Matic (Unofficial) v0.1.0, an MIT-licensed custom integration for Matic robot vacuums.
Independent community project. Not affiliated with, endorsed by, or supported by Matic Robots Inc.
After a one-time Bluetooth authorization through the Matic app’s Add another user flow, routine control, state, and maps use the robot’s encrypted local service. No Matter connection or cloud relay is required.
What it adds
- Native vacuum controls for start/resume, pause, stop, dock, full-floor cleaning, and named-room cleaning
- A local floor-plan camera showing mapped rooms, labels, and robot position — no optical camera footage
- 44 Home Assistant entities covering activity, battery, rooms, cleaning history, firmware, Wi-Fi, schedules, dock state, diagnostics, and robot settings
- Controls for child lock, pet-waste avoidance, Hey Matic, double-pass mopping, and water flow
- Saved cleaning plans with selectable rooms, per-room mode and coverage, and drag-orderable room lists
- Intelligent rotation, which starts with rooms that have waited longest instead of always beginning at the top of the list
- Deterministic top-to-bottom plan runs when every selected room should clean in its saved order
- Home Assistant actions, room-level events, Area mapping, and ready-to-import automation blueprints
Plans define what to clean. Standard Home Assistant schedules, presence automations, scripts, scenes, and dashboards decide when they run.
Requirements
Home Assistant 2026.7 is the tested baseline and the minimum version accepted by HACS for this repository. Other Home Assistant releases have not yet been validated.
A new Bluetooth pairing requires an adapter built into or directly attached to the Home Assistant host. Bluetooth proxies cannot relay the robot-displayed passkey exchange. Bluetooth is used only for authorization; normal operation is over the local network.
This first release has been tested on a real Matic robot and a stock Home Assistant Yellow, with automated test coverage for the integration. Because it uses an unofficial local protocol, future robot firmware changes may require integration updates.
Installation
HACS custom repository
- Add GitHub - ProspectOre/matic-home-assistant: Unofficial local-only Home Assistant integration for Matic robot vacuums · GitHub to HACS as a custom Integration repository.
- Install Matic (Unofficial) and restart Home Assistant.
- Open Settings → Devices & services and select the discovered robot.
- In the Matic app, open Settings → Connectivity → Add another user and enable Pairing mode.
- Continue in Home Assistant and enter the six-digit code shown on the robot if requested.
For manual installation, copy custom_components/matic_robot into Home Assistant’s custom_components directory and restart.
Links
Bug reports and compatibility feedback are welcome through the repository’s issue forms. Home Assistant diagnostics are generated only when you click Download diagnostics; sensitive identifiers are redacted, but please inspect home-specific map and room context before posting.