MapitDevelopers Beta mapit.me ↗

Integration

Home Assistant

Mapit's own Home Assistant integration puts each of your vehicles on the map as a device tracker, with sensors for its battery and when it last reported.

Beta. The Mapit API behind it is a beta, free for now. See the beta terms.

Install

You need Home Assistant 2026.10 or newer, and a Mapit account with at least one vehicle. With HACS:

  1. Add https://github.com/mapit-iot/home-assistant-mapit as a custom repository, with the category Integration.
  2. Install Mapit and restart Home Assistant. HACS installs the latest release.
  3. Go to Settings > Devices & services > Add integration and pick Mapit.
  4. Sign in with your Mapit account and tick Also allow vehicle location and last reported device status. Home Assistant cannot show your vehicles without it.
  5. The first time, my.home-assistant.io asks for your Home Assistant URL (it suggests http://homeassistant.local:8123). Enter the address you open Home Assistant at and press Link account. The address is stored only in that browser.
  6. Home Assistant opens a Name and assign dialog that lists every vehicle, where you can choose an area for each. Skip and finish is fine too. Your vehicles appear.

Without HACS, download the source of the latest release, not main, copy its custom_components/mapit folder into your Home Assistant config/custom_components folder, and restart Home Assistant. Home Assistant downloads aiomapit from PyPI on that first restart, so it needs internet access. Then continue from step 3.

What you get

Each vehicle becomes a device with these entities:

EntityWhat it shows
Device tracker (the vehicle's name)The last position reported. A vehicle that never reported a position shows unknown.
Mapit batteryThe tracker's own battery, not the vehicle's.
Last communicationWhen the tracker last reported anything.
Last locationWhen the position was reported.
OdometerThe mileage stored in Mapit.
StatusWhat the tracker last reported, as listed below.
Vehicle voltageThe vehicle's supply seen by the tracker. Disabled by default: turn it on in the entity settings.

Everything is last reported, not live. The status shows one of these values, with the same labels as the Mapit app:

A vehicle that never reported, or reports a status not listed here, shows unknown.

How it works

Integrations that ask for your password

Some community integrations sign in with your Mapit email and password. They hold your password, and they can stop working whenever the Mapit app changes. We recommend moving to the official integration and then changing your Mapit password.