The Neakasa Home Assistant Custom Integration allows you to integrate your Neakasa devices with your Home Assistant setup.
- Neakasa M1 (Cat Litter Box)
| Sensor | Unit | Example Value | Enabled by default |
|---|---|---|---|
| Cat litter level | percent | 80 % | yes |
| WiFi RSS | dB | -60 dB | no (debug information) |
| Last stay time | seconds | 45 s | no |
| Last usage | datetime | 2024-12-07 14:52 | yes |
| Device status | idle / cleaning / leveling / flipover | idle | yes |
| Cat litter state | insufficient / moderate / sufficient | sufficient | yes |
| Bin state | normal / full / missing | normal | yes |
| Binary Sensor | Example Value | Enabled by default |
|---|---|---|
| Garbage can full | off | yes |
| Button | Action | Enabled by default |
|---|---|---|
| Clean | Cleans the litter box | yes |
| Level | Initiates the leveling process | yes |
| Switch | Enabled by default |
|---|---|
| Kitten mode | no (rare edgecase) |
| Child lock | yes |
| Automatic cover | yes |
| Automatic leveling | yes |
| Silent mode | yes |
| Automatic recovery | no (potentialy dangerous!) |
| Unstoppable cycle | yes |
This integration is available in HACS (Home Assistant Community Store).
- Install HACS if you don't have it already
- Open HACS in Home Assistant
- Go to any of the sections (integrations, frontend, automation).
- Click on the 3 dots in the top right corner.
- Select "Custom repositories"
- Add following URL to the repository
https://github.com/timniklas/hass-neakasa. - Select Integration as category.
- Click the "ADD" button
- Search for "Neakasa"
- Click the "Download" button
To install this integration manually you have to download neakasa.zip and extract its contents to config/custom_components/neakasa directory:
mkdir -p custom_components/neakasa
cd custom_components/neakasa
wget https://github.com/timniklas/hacs_blitzerde/releases/latest/download/neakasa.zip
unzip neakasa.zip
rm neakasa.ziprestart Home Assistant.
with this variant, you can easily update the integration from the github repository.
cd <to your Home Assistant config directory>
git clone https://github.com/timniklas/hass-neakasa
mkdir custom_components
cd custom_components
ln -s ../hass-neakasa/custom_components/neakasa/ .restart Home Assistant.
cd <to your Home Assistant config directory>
cd hass-neakasa/
git pullrestart Home Assistant.
From the Home Assistant front page go to Configuration and then select Devices & Services from the list.
Use the Add Integration button in the bottom right to add a new integration called Neakasa.
- When you discover that the mobile app is starting over and over, beginning again with the login steps, then you should use this HA integration with a different account than with the app. Create a second account and use the share function in the app - simply share the device with the second account
- powercycle the litterbox
- reset the litterbox and reintegrate it
- open an issue
If you find a problem, feel free to report it and I will do my best to help you. If you have something to contribute, your help is greatly appreciated! If you want to add a new feature, add a pull request first so we can discuss the details.
This custom integration is not officially endorsed or supported by Neakasa. Use it at your own risk and ensure that you comply with all relevant terms of service and privacy policies.
