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/4G)
- Camera stream
- Scheduling
- Mapping and zone management
- Maps
- 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!
-
Supports Spino pool cleaners
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.
Companion HACS dashboard plugins that extend the Mammotion integration with visual tools.
Images and scripts for displaying Mammotion mowers on a map in Home Assistant — mower card backgrounds, side-profile images, map icons, RTK/dock assets, and the geojson.js script that renders mowing areas with labels.
A Lovelace resource that renders GeoJSON mowing areas on the map with area names and zone labels.
An interactive Lovelace card for placing, editing, and deleting SVG pattern tiles on your mower's map directly from the dashboard. Load an SVG, drag it into position, scale and rotate it, then send it to the device in one click via the mammotion.svg_add service.
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)
