Nissan Connect smart home integration, free and open source

Battery, range, charge and climate of your Nissan electric car (Leaf, Ariya…).
This integration brings your Nissan electric car into Gladys through the NissanConnect Services cloud — the same service as the Nissan mobile app. You see the battery, the range, the charge and the climate, you can start the climate or the charge, and you can use all of it in scenes and on the dashboard.
Before you start
- Gladys 5.3 or later.
- A NissanConnect Services account (Europe), with your car activated in the mobile app. If the app shows your car and its battery, this integration can too.
- The integration works through the Nissan cloud only: it never talks to the car on your local network, and it needs internet access.
Nissan offers no public API. The integration speaks the same language as the official app, which Nissan may change without notice. Not every model answers every request: a LEAF, for example, gives no door lock status.
Configuration
Open Integrations → Nissan Connect → Configuration.
| Field | What to put in |
|---|---|
| NissanConnect login (e-mail) | The e-mail you sign in to the NissanConnect Services app with. |
| NissanConnect password | Its password. Gladys keeps it as a secret; it is never written in the logs. |
| Refresh interval (s) | How often Gladys reads what the car last sent to the Nissan cloud. Default 900 (15 min), minimum 300. This does not wake the car up. |
| Car wake-up interval (min) | How often the car itself is asked to send fresh data. Default 0 = only when you ask. Each wake-up uses the car's 12 V battery: if you turn it on, choose a large value (for example 240). |
| Distance unit | Kilometres or miles, for the range and the odometer. |
| Climate temperature (°C) | Cabin temperature used when the climate is started without one (16 to 30 °C). |
Then click Test the connection: the answer lists the cars found in your account.
Add your car
Open Integrations → Nissan Connect → Discovery and create the car. One Gladys device per car of the account, named after the nickname set in the app.
If you change the distance unit later, open Discovery again and update the car, so its range and odometer show the new unit.
What the car device shows
| Feature | Description | Control |
|---|---|---|
| Battery | State of charge, in %. | — |
| Range | Estimated range, in km or miles. | — |
| Plugged in | Whether the charging cable is connected. | — |
| Charging | Whether the car is charging. | Start / stop |
| Climate | Whether the climate (pre-heating / pre-cooling) is running. | Start / stop |
| Climate temperature | Temperature asked for the next climate start. | 16 to 30 °C |
| Cabin temperature | Temperature inside the car, when the car reports it. | — |
| Odometer | Total distance, in km or miles. | — |
| Locked | Whether the doors are locked, when the car reports it. | — |
Remote commands are carried out by the car a little later: Gladys shows the requested state at once, then reads the car again about 90 seconds later to confirm it.
The transport badge of the device says how fresh the data is:
- Cloud: the last read worked.
- Unreachable: the Nissan cloud did not answer at the last read.
- Cloud with an orange dot: the cloud answers, but the car has sent nothing for more than 24 hours (asleep, parked underground, out of coverage). Use Wake up a car.
Read or wake up?
- A read asks the Nissan cloud what the car last reported. It is cheap and happens at every refresh interval.
- A wake-up asks the car itself to send fresh data. It goes through the mobile network and uses the 12 V battery. The new data reaches Gladys a few minutes later.
Wake the car up from the Wake up a car button, the Refresh button of the widget, the Read the status of a Nissan scene action (with "Wake the car up first"), or automatically with the Car wake-up interval.
Configuration screen buttons
- Test the connection: logs in and lists the cars of the account.
- Wake up a car: asks the chosen car to send fresh data (battery and position).
- Identify a car (flash the lights): the car flashes its lights, handy in a car park.
Scenes
Triggers
- A Nissan car starts or stops charging — filters: the car, the event (charge started, charge stopped).
- A Nissan car is plugged in or unplugged — filters: the car, the event (plugged in, unplugged).
Both give the scene these variables: the car name, the event, the battery level (%) and the range. They are seen at the next read of the car, so with a delay of up to the refresh interval, not at the exact second. They never fire on the first read after Gladys starts.
For a threshold ("battery below 20 %"), use the standard Gladys device state trigger on the Battery feature.
Actions
- Start or stop the climate of a Nissan — the car, start or stop, and an optional temperature. Output: order accepted.
- Start or stop the charge of a Nissan — the car must be plugged in. Output: order accepted.
- Read the status of a Nissan — reads the car now, optionally waking it first. Outputs: battery (%), range, plugged in, charging — use them in the next actions ("if battery < 30, send me a message").
- Flash the lights of a Nissan — lights only, or lights and horn. Output: order accepted.
A refusal from Nissan does not stop the scene: the order accepted output is then false, and you can test it in a condition.
Examples:
- Every weekday at 7:40, start the climate at 21 °C.
- When the car is unplugged and its battery is below 50 %, send a message.
- When the car stops charging, read the status and announce the range.
Dashboard widget
Add the Nissan car widget to a dashboard. Settings:
- Car: the car to show (the first one of the account when left empty).
- Show the map button: adds a button that opens the car's last position on OpenStreetMap. Off by default: leave it off on a dashboard other people can see.
The widget shows the live battery and range, whether the car is plugged in and charging (with the time left), the climate, the doors and the time of the last car data. Its buttons: Refresh (wakes the car up), Start / Stop climate, Start / Stop charge (only when plugged in), and the map. The climate and charge buttons ask for a confirmation.
Troubleshooting
| Symptom | What to do |
|---|---|
| "Nissan refused the login or password" | Check them by signing in to the NissanConnect Services app, then type them again in Gladys. |
| "Connected, but this NissanConnect account has no car" | Activate the car in the mobile app first, then Test the connection again. |
| The values never change | The car has not reported anything new: use Wake up a car, then wait a few minutes. |
| A feature stays empty (cabin temperature, locked) | Your model does not report it to the Nissan cloud. |
| A command is refused | The car may be asleep, out of coverage, or not support it (charge control on some models). |
| "NissanConnect Services unreachable" | The Nissan cloud is down or has changed: try again later, and check for an integration update. |
The integration logs (Integrations → Nissan Connect → Logs) never contain your password or tokens; error lines name the request and the car VIN.
Privacy
- Your login and password are only sent to the Nissan identity server, over HTTPS.
- The access tokens stay in memory, never on disk.
- The car's position is only used for the optional map button of the widget.
- The integration never locks or unlocks the doors and never asks for the car PIN.
Configuration settings
These are the settings Nissan Connect asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Getting started | section | No | This integration uses the NissanConnect Services cloud (Europe), the same as the mobile app: fill in the login and password of that app. Your car must be activated in the app first. Nissan offers no public API: the integration speaks the app's own language, which Nissan may change without notice. |
| NissanConnect login (e-mail) | string | Yes | The e-mail address you sign in to the NissanConnect Services app with. |
| NissanConnect password | secret | Yes | Kept by Gladys as a secret, never written in the logs. |
| Refresh interval (s) | number | No | How often Gladys reads, in seconds, what your car last sent to the Nissan cloud. It does not wake the car up. |
| Car wake-up interval (min) | number | No | Every how many minutes the car itself is asked to send fresh data. Each wake-up uses the car's 12 V battery: keep 0 (only when you ask) or a large value such as 240. |
| Distance unit | select | No | Unit of the range and the odometer. Changing it later needs the car to be updated from the Discovery screen. |
| Climate temperature (°C) | number | No | Cabin temperature asked for when the climate is started without one (16 to 30 °C). |
How to install Nissan Connect in Gladys
- In Gladys, open Integrations: Nissan Connect appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/prohand/gladys-nissanconnect:0.0.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/prohand/gladys-nissanconnect.
Nissan Connect requires Gladys >=5.3.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Nissan Connect is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by prohand, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation