Flespi custom integration for GPS trackers

Share your Projects! Custom Integrations
,
1

Hi,

Sharing a HACS custom integration - Flespi. It connects Home Assistant to GPS trackers and telematics devices through flespi, a cloud platform that supports Teltonika, Queclink, Concox, GalileoSky, Ruptela and 100+ other protocols, normalizing everything into JSON over MQTT and REST.

If you have a tracker on your car, motorcycle, boat, or anything else and you want it on the HA map without writing your own protocol parser - this is the path of least resistance. flespi is free within the free-tier limits, which is usually plenty for personal setups.

Repo: GitHub - dexif/ha-flespi: Home Assistant integration for flespi - GPS trackers and telematics devices, with auto-discovered sensors and binary_sensors. · GitHub

What you get

Per device:

  • device_tracker - location on the map
  • Sensors for speed, altitude, direction, satellites, battery voltage
  • binary_sensor online/offline status
  • Auto-discovery: every telemetry parameter the device reports becomes a sensor or binary_sensor with proper device_class and units. Common ones (fuel, ignition, external power) enabled by default; the rest added disabled - enable what you need

Account counters (new in 0.6.0):
With a Master-level token, add "Account counters" to your connection - ~140 sensors for flespi platform usage: API calls, MQTT messages/sessions, device/channel/stream counts, storage, traffic, plan limits. Push-fed via retained MQTT, no polling.

Works great with Vehicle Status Card for a car-dashboard-style UI.

image
image575×1280 84.7 KB

How it connects

Two modes, picked in the config flow:

  • Direct to the flespi MQTT broker - paste a flespi token, search your devices by name or IMEI, pick one. No mosquitto bridge, no YAML.
  • Via HA's MQTT integration - for setups that already bridge flespi into a local broker (will be deprecated soon)

One token covers many devices: enter it once, then add each device as a subentry from the integration card. All devices on the same token share a single MQTT session.

Install

HACS -> Custom repositories -> add https://github.com/dexif/ha-flespi as Integration -> install -> restart -> Settings -> Devices & Services -> Add Integration -> Flespi.

Feedback welcome - interested to hear which device models people use and which telemetry parameters should be enabled by default. Issues and PRs on GitHub.

1 Like