This integration allows you to control and monitor Mammotion products, e.g robot lawn mowers using Home Assistant.
- Bluetooth (BLE) support
- Wi-Fi support (Including SIM 3G)
- Scheduling
- Mapping and zone management
- Firmware updates
- Automations
- More...
- Start, stop, pause, and dock the mower
- Monitor the mower's status (e.g., mowing, charging, idle)
- View the mower's battery level
- Start a mow based on configuration
- Start an existing scheduled task/s
- More features being added all the time!
Warning
Home Assistant Minimum Version 2026.1.0
- A second account with your mower/s shared to it for using Wi-Fi (If you use your primary accouunt it will log you out of your mobile app)
- (Optional)Bluetooth proxy for Home Assistant
-
Sometimes using the account number works instead of email address when adding via discovery (not sure why)
-
Connection timeout to host https://api.link.aliyun.com/living/account/region/get - unblock china
This integration can be installed using HACS
This integration is not available in the default HACS store. You will need to add it as a custom repository.
- Go to HACS > Integrations and click on the 3 dots in the top right corner.
- Select "Custom repositories".
- In the "Repository" field, paste this URL:
https://github.com/mikey0000/Mammotion-HA - For "Category", select "Integration".
- Click "Add".
- You can now search for "Mammotion" within HACS and install it.
- After installation, restart Home Assistant.
- Go to Settings > Devices & Services and click + Add Integration to configure Mammotion.
See the wiki for how to get started
Once the integration is set up, you can control and monitor your Mammotion mower using Home Assistant. 🎉
Satellite map tiles (Google Maps, OpenStreetMap, etc.) are sometimes misaligned relative to RTK GPS coordinates by several metres. Each mower exposes two number entities to correct this:
- Map offset latitude — shifts the mower pin north (positive) or south (negative), in metres
- Map offset longitude — shifts the mower pin east (positive) or west (negative), in metres
How to calibrate:
- Add a Map card and both offset entities to a Lovelace dashboard.
- Start the mower so it is moving at a known location you can identify on satellite imagery.
- Adjust Map offset latitude and Map offset longitude until the pin aligns with the mower's real position on the satellite layer.
- Values are saved automatically and survive restarts.
Typical offsets are within ±20 m. Positive latitude = north, positive longitude = east.
If you encounter any issues with the Mammotion integration, please check the Home Assistant logs for error messages. You can also try the following troubleshooting steps:
- Verify that you have Bluetooth proxy setup with Home Assistant.
- Ensure that your mower is connected to your home network and accessible from Home Assistant.
- Restart Home Assistant and check if the issue persists.
- Make sure your not blocking China (Connection timeout to host https://api.link.aliyun.com/living/account/region/get)
We use Crowdin to manage our translations. If you'd like to contribute:
- Visit our Crowdin project page
- Select the language you'd like to translate to
- Start translating!
Your contributions will be automatically submitted as pull requests to this repository.
This integration uses the PyMammotion library to communicate with Mammotion mowers. PyMammotion provides a Python API for controlling and monitoring Mammotion robot mowers via MQTT, Cloud, and Bluetooth.
If the problem continues, please file an issue on the GitHub repository for further assistance. 🙏
Buy a Mammotion Lawn Mower (Amazon) Buy a Mammotion Lawn Mower (Mammotion)