pymammotion
Decision gist · record as of 2026-08-14
Yes, if you own a Mammotion mower and accept the Terms of Service risk. The library is actively maintained, has low install friction, and integrates well with Home Assistant. No, if you require GPL-3.0 compatibility guarantees or need support for older Python versions. The copyleft license and account-ban warning are non-negotiable constraints for some users.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.13 or later.
- Mammotion's Terms of Service prohibit unofficial API access; using this library risks permanent account ban.
- Low install friction with a pure Python wheel.
License · maintenance · safety
GPL-3.0 (copyleft) — Licensed under GPL-3.0 (copyleft). Any application using PyMammotion must also be distributed under GPL-3.0 or a compatible license; proprietary or closed-source projects cannot use it without relicensing.
last release 2026-08-13 (1 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 101,214 downloads/mo, #12,954 on PyPI
Alternatives
Verify before relying
pip install pymammotion
import pymammotion
# Initialize client with MQTT or Bluetooth connection
# See GitHub wiki for device-specific setup and examples- Exact scope of supported Mammotion device models and firmware versions
- Whether MQTT, cloud, and Bluetooth modes are equally mature or if some are experimental
- Real-world stability and reliability reports from active users
- Performance and latency characteristics for remote control operations
What it is and what it does
PyMammotion is a Python library for interacting with Mammotion robotic lawn mowers through multiple transport layers: MQTT, cloud APIs, and Bluetooth. It abstracts the device communication protocol and provides a programmatic interface for control and telemetry, making it suitable for automation frameworks like Home Assistant or custom monitoring scripts.
The library is under active development (latest release 2026-08-13) and carries a significant warning: Mammotion's Terms of Service explicitly prohibit unofficial API access, and using this library may result in permanent account or device bans. The codebase depends on 21 runtime packages including protobuf serialization, cryptographic signing (PyJWT, cryptography), async I/O (aiohttp, websockets, aiomqtt), and geometric computation (shapely, numpy). It requires Python 3.13 or later.
Use it for
- Integrate Mammotion mowers into Home Assistant for centralized lawn care automation and scheduling
- Build custom monitoring dashboards that pull telemetry and status from multiple mowers via MQTT
- Automate mower commands (start, stop, dock) based on weather, time, or external triggers
- Develop IoT applications that coordinate mower operation with other smart home devices
- Create diagnostic or fleet-management tools for users with multiple Mammotion devices
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own a Mammotion mower and accept the Terms of Service risk.
The library is actively maintained, has low install friction, and integrates well with Home Assistant. No, if you require GPL-3.0 compatibility guarantees or need support for older Python versions. The copyleft license and account-ban warning are non-negotiable constraints for some users.
Install
pymammotion on PyPI
Before you install
Low install friction with a pure Python wheel. Active maintenance as of 1 day ago. Requires Python 3.13 or later, which narrows compatibility to recent environments. The 21 runtime dependencies are substantial but mostly established packages (aiohttp, websockets, protobuf, cryptography).
Requires Python 3.13 or later. Mammotion's Terms of Service prohibit unofficial API access; using this library risks permanent account ban.
License in practice
Licensed under GPL-3.0 (copyleft). Any application using PyMammotion must also be distributed under GPL-3.0 or a compatible license; proprietary or closed-source projects cannot use it without relicensing.
Quickstart
pip install pymammotion
import pymammotion
# Initialize client with MQTT or Bluetooth connection
# See GitHub wiki for device-specific setup and examplesVerify before relying
- Exact scope of supported Mammotion device models and firmware versions
- Whether MQTT, cloud, and Bluetooth modes are equally mature or if some are experimental
- Real-world stability and reliability reports from active users
- Performance and latency characteristics for remote control operations
Package facts
| License | GPL-3.0 copyleft |
| Python support | Supports the current Python release >=3.13 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 21 packagesaiohttpaiomqttalibabacloud-apigateway-utilalibabacloud-iot-api-gatewaybetterproto2bleak-retry-connectorbleakcrcmodcryptographymashumaronumpyorjsonpillowprotobufpyjwtpyrsistentpython-dotenvsdp-transformshapelywebrtc-modelswebsockets |
| Maintenance | Actively maintained 1 days since the last release |
| First released | |
| Downloads | 101,214 / month, #12,954 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: pymammotion-0.8.13-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “mammotion mower control api”
- pymammotionPyMammotion provides a Python API to control and monitor Mammotion…
- pyworxcloudAsync Python client library for communicating with Worx Cloud lawn…
- aioautomowerAsynchronous Python client library for communicating with the…
Give your agent the search over MCP, or paste the wish link into any chat.
More Internet packages
Botocore provides low-level, data-driven access to Amazon Web Services APIs, serving as the foundation for the AWS CLI and boto3 libraries.
Install it if you need programmatic access to AWS services.
Provides an async client for AWS services using botocore and aiohttp, allowing you to call AWS APIs asynchronously within asyncio-based applications.
Install it if you need to call AWS services from async Python code; it is the standard way to do so.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides a platform-independent file locking mechanism to coordinate access to files across processes and threads.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides common Protocol Buffer message definitions used across Google Cloud APIs, enabling Python clients to interact with Google services.
See also pyworxcloud · aioautomower · HATasmota · tuya-device-sharing-sdk · gardena-bluetooth · deebot-client · pysmappee · switchbot-api · xiaomi-ble · meross-iot