About
Neakasa Litterbox connects the Neakasa M1 self-cleaning litter box to Home Assistant through the vendor's cloud. One account entry exposes every litter box bound to it, plus a sub-device for each cat profile registered in the Neakasa app. It adds sensors for last visit, visits today, weight, sand level and status, binary sensors for a full waste bucket and cleaning needs, and switches for auto clean, auto level, child lock and silent mode. Buttons start cleaning or leveling, and a number control handles sand calibration. State arrives in real time over an MQTT push stream, with polling as a fallback, and the polling interval and statistics lookback can be changed in the options. Setup happens in the UI with the app email, password and region, and the same fields serve re-authentication and reconfiguration.
Automatic summary of the README and code of roquerodrigo/ha-neakasa-litterbox. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
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.
Set up Neakasa Litterbox
- Password
- Region
Also asked when signing in again and changing the connection.
After setup
- Polling interval (seconds)
- Statistics lookback (days)
Texts from the code of roquerodrigo/ha-neakasa-litterbox.
Entities
- Binary sensorsWaste bucket full, Needs cleaning
- ButtonsClean now, Level now
- NumbersSand calibration
- SensorsLast visit, Visits today, Weight, Sand level, Status
- SwitchesAuto clean, Auto level, Child lock, Silent mode
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
Home Assistant integration for the Neakasa M1 self-cleaning litter box. Talks to the Neakasa cloud through the neakasa-litterbox-sdk, so it works without LAN-side setup: one config entry per account exposes every litter box bound to it, plus a sub-device per cat profile registered in the Neakasa app.
The integration is cloud push: an MQTT status stream keeps state in real time, with a longer polling cadence as a safety net.
- Multiple litter boxes per account, discovered dynamically.
- Sub-device per cat, linked to its litter box in the device registry.
- Real-time updates via MQTT push, with polling fallback (default 10 min).
- Optimistic UI: switches, the calibration slider and buttons reflect new state immediately; the device confirms via push within seconds.
- Per-region (US / EU / AP) login, reauth and reconfigure flows.
- Translations: English and Brazilian Portuguese.
Information
- Installs
- 67 sharing analytics
- GitHub stars
- 8
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v1.4.3,
- Category
- Appliances and cleaning, Cleaning
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
neakasa_litterbox- Issues
- Report an issue
