Connect your Windows PC to Home Assistant.
Download for Windows · Notification examples · PC commands · Custom commands · Report an issue
Report useful PC status, show Home Assistant notifications in Windows, and run the PC actions you choose. HASS Connect stays in the tray and uses Home Assistant’s Mobile App integration. No MQTT broker or custom integration is required.
HASS Connect supports Windows 11 x64. Download Setup from the latest release.
Setup downloads the Microsoft runtimes it needs, so the first installation requires an internet connection. The installer is currently unsigned, and Windows may show an unknown-publisher warning.
- Run the installer, then open HASS Connect from Start.
- Open Settings, enter your Home Assistant address and a long-lived access token, then connect.
- Enable the sensors and notifications you want.
In Home Assistant, open your profile and select Security to create a long-lived access token. Closing the window keeps the app in the tray. The tray menu also opens Home Assistant in your browser. Choose Quit to stop the app.
 |
 |
| Sensors | Windows notifications |
 |
 |
| PC controls | Trusted custom commands |
All sensors are off by default. Enabled sensors report every 15 seconds.
| Sensor | Reports |
|---|---|
| CPU usage | Processor use across all cores |
| Memory usage | Physical memory in use |
| Idle time | Time since keyboard or mouse input |
| Uptime | Time since Windows started |
| Session locked | Whether the current Windows session is locked |
| Display state | On, dimmed or off for the current session |
| Last seen | Timestamp of the latest report |
| Microphone / webcam | Whether an application is using the device |
| Battery level | Charge remaining, where a battery is present |
| Battery charging | Whether the system battery is charging |
| Storage | One switch per fixed disk, with usage and free-space entities |
| IP address | Local IPv4 address used to reach Home Assistant |
| Network adapter | Adapter used for that connection |
| Download / upload speed | Total traffic on that adapter, in Mbit/s |
Sensors can be disabled in either the app or HA. Enable sensors pauses reporting without changing your selections. HA retains the last values while the PC is offline; enable Last seen and add a freshness condition before automating on CPU usage, idle time or other readings.
Enable notifications, then use the notify action created for your PC:
action: notify.mobile_app_your_pc
data:
message: Motion at the front door
data:
tag: front-door
image: /media/local/camera/snapshots/front-door.jpg
action_data:
alert_id: front-door-001
actions:
- action: URI
title: Open camera
uri: /dashboard-cameras/front-door
- action: CONFIRM_FRONT_DOOR
title: ConfirmUse an existing snapshot and your dashboard’s path. Reusing a tag replaces the
previous alert. Action buttons return mobile_app_notification_action to HA with
the alert context; URI buttons open the browser.
Notification examples cover clearing alerts, images and click events. The app must be running and connected. Windows Do not disturb can suppress banners.
PC control is off until you enable it. The built-in commands can lock, sleep, shut down or restart the PC, turn off its displays, and control media or volume. Each command has its own switch.
For anything else, create a custom command by choosing the exact .exe and fixed arguments
on the PC. Home Assistant can trigger the saved command but cannot change what it runs. See
the PC command reference and custom-command guide.
Credentials are encrypted for your Windows account. Settings and logs stay in
%LOCALAPPDATA%/HassConnect. No location updates are sent. Home Assistant may create
a device tracker during registration; you can disable it.
The Updates section checks GitHub automatically. After confirmation, HASS Connect can download, verify and open the official Setup bundle; nothing is installed without user action.