Home Assistant Integration

Entities

What Gets Pushed

Moofment creates five entities in your Home Assistant instance, updated in real time via Bluetooth.

Battery

0–100% with device class

Lock

Locked / Unlocked

Speed Mode

EU, US, JP, or Offroad

Connection

Connected / Disconnected

Odometer

Total distance in km

Setup

Get Started in 4 Steps

It takes about two minutes to connect Moofment to your Home Assistant instance.

Create an Access Token

In Home Assistant, go to your Profile → Security (or visit /profile/security). Scroll down to Long-Lived Access Tokens and create a new token. Copy it.

Enable in Moofment

Open Moofment and go to Profile → Preferences → Home Assistant. Toggle Push Bike State on.

Enter Server URL & Token

Enter your Home Assistant base URL, e.g. http://192.168.1.100:8123. Then tap Configure Access Token and paste your token. Do not include any path after the port number.

Test & Connect

Tap Test Connection to verify. Then connect to your bike via Bluetooth — entities will appear in Developer Tools → States within seconds.

Example: Dashboard Card

Add this YAML to your Lovelace dashboard to display your bike's status.

configuration.yaml

type: entities
title: VanMoof
entities:
  - entity: sensor.vanmoof_<id>_battery
    name: Battery
  - entity: binary_sensor.vanmoof_<id>_lock
    name: Lock
  - entity: sensor.vanmoof_<id>_speed_mode
    name: Speed Mode
  - entity: binary_sensor.vanmoof_<id>_connection
    name: Connection
  - entity: sensor.vanmoof_<id>_odometer
    name: Odometer

Automations

Ideas to Get You Started

Use Home Assistant automations to react to your bike's state changes.

🔋

Low Battery Alert

Get a notification on your phone when battery drops below 20%.

🏠

Arrive Home

Turn on hallway lights when your bike disconnects near home.

🔒

Lock Reminder

Alert if your bike has been unlocked for more than 10 minutes.

📊

Dashboard Display

Show live battery and distance on a wall-mounted tablet.

Good to Know

Notes

Entities are read-only — Moofment pushes data to HA, but you cannot control the bike from HA.

Data is pushed only while the app is in the foreground and the bike is connected via Bluetooth.

Only the selected bike in Moofment is pushed. If a different bike is connected, it will be ignored.

Entity IDs are based on your bike's frame number, so they stay stable even if you rename the bike.

Your access token is stored securely in the iOS Keychain and never leaves your device.

Moofment and Home Assistant must be on the same local network, or you need to configure remote access.

Home Assistant.