MOOX Track – Cloud integration for Home Assistant

Cloud GPS tracking integration for Home Assistant. Connect your MOOX Track account and vehicles equipped with MOOX devices to enable real-time tracking, advanced alarms, and more than 40 sensors for continuous 24/7 fleet monitoring without supervision.

🌟 Features

📍 Real-time GPS tracking – Device tracker with coordinates, accuracy, and Home Assistant zone mapping
🗺️ Dual geofencing – Native MOOX alarms plus Home Assistant zones for advanced automations
⚡ Speed and motion – Speed in knots/kmh, motion status, odometer, course
🚨 Events and alarms – Ignition, towing, jamming, overspeed, harsh driving, inactivity, and more
📡 Signal quality – Satellites, RSSI, GPS fix quality, prioritized warnings
🔋 Power – Vehicle voltage, battery %, low-power detection
🔧 OBD-II (optional) – RPM, fuel, DTC list/counter on compatible trackers
🎯 Automation ready – 40+ sensors, Home Assistant events, detailed diagnostics
🔐 Zero external dependencies – Direct HTTPS to the MOOX cloud, no extra Python packages

📦 Installation

Prerequisites

Home Assistant 2025.11 or newer
MOOX Track account (https://app.moox.it)
At least one GPS device registered to your MOOX Track account

💡 Demo account: Email demo@moox.it | Password demo

HACS (recommended)

Open HACS → Integrations
Click ⋮ → Custom repositories
Add repository https://github.com/moox-it/hass-moox-track
Category: Integration
Install MOOX Track and restart Home Assistant

💡 Open directly in HACS

Manual installation

Download the latest release
Extract custom_components/moox_track into /config/custom_components/
Restart Home Assistant

⚙️ Configuration

Initial setup

Settings → Devices & Services → + Add Integration
Search for "MOOX Track"
Enter your MOOX Track email and password
Devices will be discovered automatically

💡 Open the config flow directly

Integration options

Configure via Settings → Devices & Services → MOOX Track → Configure:

Update interval (seconds, minimum 30): Poll interval for updates
Max accuracy (meters, default 0): Ignore positions with worse accuracy inside Home Assistant only (does not change device parameters)
Custom attributes: Copy custom attributes from device/position data to the device tracker
Skip accuracy filter for: Attributes that bypass the accuracy filter (useful for critical alarms)
Events: Enable Home Assistant events for selected event types

Important: The Max accuracy filter and other options only affect what Home Assistant stores and displays. They do not change any parameter on the GPS device. Device configuration must be managed via the MOOX Track app.

📱 Device configuration

Important: Event, alarm, and warning detection must be configured in the MOOX Track application. The integration reads and displays the values transmitted by the device.

Alarm and warning configuration

Open the MOOX Track application (https://app.moox.it or mobile app)
Tap/click the device name → "Alarms and warnings"
Enable and configure the desired events/alarms/warnings based on device capabilities

Download the apps:

Web: https://app.moox.it
Android: Google Play Store
iOS: Apple App Store

Geofence: app vs Home Assistant

Two separate systems:

MOOX Track app geofences (configured in the app):
- Created and managed inside the MOOX Track application
- Generate alarms/warnings when the device enters/exits
- Trigger the alarms sensor with values like "Enter Area" or "Exit Area"
Home Assistant zones (configured in Home Assistant):
- Created under Settings → Zones
- Used by the device tracker to show home, away, or the zone name
- Completely separate from the app geofences

For automations: If you want to trigger automations on geofence entry/exit, use the alarms sensor with values "Enter Area" or "Exit Area" (from the MOOX Track app geofences), not Home Assistant zones.

🔧 Entities and sensors

Each device creates:

1 Device Tracker ([01·TRK]) – Main tracking entity
20 Visible Sensors – GPS, motion, system, events, alarms
20 Hidden Diagnostic Sensors – Battery level, OBD-II, timestamps, last GPS fix data
5 Binary Sensors – Motion, ignition, state, I/O

Key sensors

Sensor	Entity ID	Description
Device tracker	`device_tracker.{device_name}`	Main tracking entity
Speed (km/h)	`sensor.{device_name}_speed_kmh`	Current speed
Altitude	`sensor.{device_name}_altitude`	Elevation
Voltage	`sensor.{device_name}_power`	Vehicle voltage
Odometer	`sensor.{device_name}_odometer`	Total distance
Event	`sensor.{device_name}_event`	Event text
Alarms	`sensor.{device_name}_alarms`	Detected alarms
Geofence	`sensor.{device_name}_geofence`	Current geofence name
Satellites	`sensor.{device_name}_sat`	GPS satellite count
RSSI	`sensor.{device_name}_rssi`	Cellular signal strength
Motion	`binary_sensor.{device_name}_motion`	Motion detection
Ignition	`binary_sensor.{device_name}_ignition`	Ignition state

See the full documentation for the complete list of sensors and their values.

🎯 Automations

Example: device tracker

automation:
  - alias: "Car left home"
    trigger:
      - platform: state
        entity_id: device_tracker.my_car
        from: "home"
        to: "not_home"
    action:
      - service: notify.mobile_app
        data:
          title: "🚗 Vehicle alert"
          message: "The car left home"

Example: events

Enable events in the integration options, then listen for moox_track_event:

automation:
  - alias: "Geofence entry alert"
    trigger:
      - platform: event
        event_type: moox_track_event
        event_data:
          event: geofence_enter
          device_name: "My Car"
    action:
      - service: notify.mobile_app
        data:
          title: "📍 Geofence alert"
          message: "{{ trigger.event.data.device_name }} entered a geofence"

Example: alarms

automation:
  - alias: "Movement alert"
    trigger:
      - platform: state
        entity_id: sensor.my_car_alarms
    condition:
      - condition: template
        value_template: "{{ 'Movement' in states('sensor.my_car_alarms') }}"
    action:
      - service: notify.mobile_app
        data:
          title: "🚨 Movement alert"
          message: "Vehicle movement detected!"

🔍 Troubleshooting

Integration will not connect

Verify MOOX Track account credentials
Check internet connectivity
Ensure Home Assistant can reach app.moox.it
Check the logs: Settings → System → Logs

No devices found

Make sure the devices are registered in the MOOX Track account
Confirm the devices are online and sending data
Reload the integration: Settings → Devices & Services → MOOX Track → ⋮ → Reload

Events/alarms do not appear

Configure them in the MOOX Track app: Events/alarms must be enabled in the device settings
Check the device model compatibility
Ensure the device is transmitting alarm/event data

🆘 Support

Documentation: moox.it
Issues: GitHub Issues
Community: Home Assistant Community Forum

Before reporting an issue: Include Home Assistant version, integration version, relevant logs, and reproduction steps.

🔐 Privacy and security

✅ Credentials encrypted and stored securely
✅ HTTPS-only communication
✅ Direct connection to MOOX Track servers
✅ Zero external dependencies
✅ No data shared with third parties

📋 Changelog

2.0.2

Automatic reconnection: continuously retries in the background for up to 12 hours when the server is unavailable or there are connection issues
Automatic session recovery with smart retry logic
Cached data displayed while reconnecting
State persistence across Home Assistant restarts

See CHANGELOG.md for full history.

📄 License

Licensed under the Apache License, Version 2.0.

MOOX SRLS
VAT: 05013370753
Via San Lazzaro n. 18
73100 Lecce, Italy

Website: moox.it
Email: info@moox.it

Full license text: LICENSE

Made with ❤️ by MOOX SRLS

Professional GPS tracking integration for Home Assistant.

FilesExpand file tree

README.md

Latest commit

History