Your Xpeng in Home Assistant, with no subscription

How it works, in one minute

Xpeng offers no official Home Assistant integration. So the data travels along two different routes that end up in the same place: a small messaging service called MQTT, which Home Assistant listens to.

My advice: if you only pick one, start with XPENG Direct (free, lots of data). Add the WiCAN Pro if you want precise, fully local readings, for example to drive charging from your solar panels.

A short glossary for beginners

What you need

• Home Assistant, installed and reachable from your computer.
• The Mosquitto broker add-on (Settings → Add-ons → Add-on store). If you already use Zigbee2MQTT, you have it.
• A dedicated Home Assistant user for MQTT: Settings → People → Users → Add, for example mqtt-xpeng, tick "local access only", not an administrator. Write down its password.
• For path 1: 2.4 GHz Wi-Fi reaching the spot where the car is parked (the WiCAN cannot see 5 GHz).
• For path 2: a device that runs 24/7 and can run Docker, plus a second XPENG account (another email address).

1Path 1: the WiCAN Pro dongle

The WiCAN Pro (part number MP-WICAN-PRO, made by MeatPi) costs about €76 excl. VAT from Mouser, or can be ordered from Crowd Supply. Do not buy the basic WiCAN: it is cheaper but too limited.

1. Install the integration in Home AssistantIn HACS, add the custom repository https://github.com/jay-oswald/ha-wican (category Integration), install it, then restart Home Assistant.
2. Plug in the dongle and connect to itPlug it into the OBD port under the steering wheel. It creates a Wi-Fi network called WiCAN_xxxxxx (password @meatpi#). Connect your phone or computer to it, then open http://192.168.0.10 in a browser.
3. Change the password straight awayOtherwise anyone walking past the car can connect to the dongle.
4. Check the firmware versionAim for v4.51. As of October 2026, v6.00 no longer queries the G6 PIDs and wipes your settings: I tried it and rolled back. Before any update, export a backup of the configuration.
5. Connect it to your Wi-FiSwitch the dongle to Station mode and pick your 2.4 GHz Wi-Fi. Note its name on the Status tab (like wican_xxxxxxxxxxxx.local) and reserve a fixed IP for it in your router.
6. Set the protocol and MQTTSettings tab:
   • CAN protocol: AutoPID. Nothing works without it; this is the number one mistake.
   • MQTT broker: Home Assistant's IP, without http:// or a port. Port 1883, with the MQTT user created earlier.
   Save (Store), then reboot the dongle from the About tab.
7. Load the lightweight G6 profileThe built-in Xpeng profile queries 234 parameters, many of which return wrong values and overload the dongle. Instead, download my 8-parameter profile xpeng_g6_wican.json and import it under Automate → Vehicle Profiles. Do not mix this profile with PIDs added by hand.
8. Wake the car and checkThe car's network does not answer while it sleeps. Sit inside with the ignition on and compare the battery percentage in Home Assistant with the one on the dashboard: they should match exactly.

2Path 2: the XPENG Direct app

XPENG Direct was written by Paul Simon and packaged as a Docker image by Stéphane Bonnell, two members of the "Hey Xpeng France !" Facebook group. It logs into the Xpeng cloud exactly like the app on your phone, then drops the data into MQTT.

1. Create a secondary XPENG accountCreate a new account in the XPENG app with another email address, then share the car with that account from your main account. Using a separate account protects your main one.
2. Choose the machine that will run XPENG DirectYou need an always-on device with Docker: a Docker-capable Synology or QNAP NAS, a Raspberry Pi 4 or 5, a mini PC, or an LXC container on Proxmox (my setup). On Debian or Raspberry Pi OS, install Docker with:

   curl -fsSL https://get.docker.com | sh

   Copy

   On Proxmox, in an unprivileged LXC container, first enable two options from the host shell (replace <ID> with the container number):

   pct set <ID> --features nesting=1,keyctl=1

   Copy
3. Start the setup assistant

   docker run -it --rm -v xpeng-storage:/data -p 8765:8765 \
     sbonnell/xpeng-direct:latest /app/setup.sh

   Copy
   Then open http://machine-IP:8765 in your browser.
4. Fill in the form
   • Log in with the secondary account.
   • MQTT: address = Home Assistant's IP (without http://), port 1883, MQTT username and password.
   • Battery capacity: for example 80 kWh for a 2026 G6.
   Confirm, then stop the assistant with Ctrl + C.
5. Check everything was savedOn my setup the broker address stayed empty despite saving, and nothing came through. This command shows the settings file:

   docker run --rm -v xpeng-storage:/data alpine \
     sh -c 'ls -l /data; cat /data/settings.json'

   Copy
   If the address is empty, repeat step 3.
6. Run XPENG Direct for good

   docker run -d --name xpeng-direct --restart unless-stopped \
     -v xpeng-storage:/data sbonnell/xpeng-direct:latest

   Copy
   The --restart unless-stopped option restarts it automatically after a power cut. To see what it is doing:

   docker logs -f xpeng-direct

   Copy
7. Find the car in Home AssistantSettings → Devices & services → MQTT: an Xpeng vehicle device appears with its sensors (level, range, locks, cable, tyres, windows, cabin, location…).

To update XPENG Direct later:

docker pull sbonnell/xpeng-direct:latest
docker rm -f xpeng-direct
# then run the “docker run -d …” command above again

3Inside Home Assistant

1. Rename the entities right awayThey arrive with unreadable names like sensor.wican_14c19f…_soc. Rename them to sensor.xpeng_g6_soc and so on (Settings → Entities → cog icon). Your cards and automations will be much easier to read.
2. Add mileage countersTwo "Utility meter" helpers on the odometer, one monthly and one yearly. They show unknown until the second reading: that is normal.
3. Work out your real consumptionCombining distance driven with the energy measured by your charger gives your real kWh/100 km and cost per 100 km. The Watt Budget calculator does the same on the price side.
4. Connect Watt Budget to Home AssistantThe car’s battery level is now a sensor: Watt Budget can read it every minute and work out your charges without you typing anything. The four steps.
5. Build your cardMy card is a custom:button-card (available in HACS). It uses XPENG Direct data when it is less than 30 minutes old, otherwise the WiCAN data, and shows the solar share of every charge. Want the same one? Get in touch through the Watt Budget contact page.

4Precautions

• WiCAN sleep: set the sleep threshold just above the 12 V voltage of the sleeping car (13.1 V on my G6), so the dongle goes to sleep at the same time.
• Read only: neither path can unlock the car or start the air conditioning. For that, stick with the XPENG app (or its Shortcuts on iPhone).
• Leased car: check your contract before leaving a device plugged in. It comes out in two seconds before you return the car.

Frequently asked questions

Links and thanks

• My repository (WiCAN profile, feedback): github.com/FranckH250/xpeng-home-assistant-wican
• XPENG Direct (Docker image): github.com/Swiiney/xpeng-direct-docker
• WiCAN firmware: github.com/meatpiHQ/wican-fw · integration: github.com/jay-oswald/ha-wican

Thanks to Paul Simon and Stéphane Bonnell for XPENG Direct, to stevelea for the work on Xpeng PIDs, to the MeatPi team and to the "Hey Xpeng France !" community.