Hermes Agent Home Assistant lets you run your smart home by chatting with an AI agent. Ask Hermes to turn off the lights, set the heating or tell you if the garage door is open, and it does it through Home Assistant. It can also watch your home and react when something changes. The official Hermes Home Assistant guide covers it, and below I’ll walk you through the setup step by step in plain English.
Key takeaways
- Install with
hermes plugins install homeassistant. - You need a Home Assistant long-lived access token and your HA URL.
- Hermes gets 4 tools: list entities, get state, list services and call a service.
- Risky domains like shell commands are blocked by default.
- Want this set up with you? Join the AI Profit Boardroom.
What Hermes Agent can do with Home Assistant
Once connected, Hermes can:
- Control devices: lights, switches, climate, covers (blinds and garage doors), media players, fans, scenes and scripts.
- Check what’s happening: read the state of any sensor or device.
- Watch for changes: get told when a door opens or a sensor changes.
- Send you updates: replies show up in Home Assistant as notifications titled “Hermes Agent”.
So you can say “turn off every light downstairs and set the living room to 21 degrees” and Hermes works out the right calls.
How to set up Hermes Agent with Home Assistant
Step 1. Install the plugin:
hermes plugins install homeassistant
Using a different Hermes profile? Run hermes -p <profile> plugins install homeassistant.
Step 2. In Home Assistant, open your profile and create a long-lived access token. (Home Assistant’s authentication docs explain tokens.)
Step 3. Add your token and URL to ~/.hermes/.env:
HASS_TOKEN=your-long-lived-token
HASS_URL=http://homeassistant.local:8123
HASS_URL defaults to http://homeassistant.local:8123. You can also set HASS_HOME_CHANNEL for where updates go.
Step 4. Start the gateway:
hermes gateway
Now ask Hermes something simple like “list my lights” to check it works.
Want help setting up Hermes Agent for your home or business? Inside the AI Profit Boardroom you get the Agent OS — Hermes, OpenClaw, OpenCode, Claude and Codex in one place — plus step-by-step Hermes training and four live coaching calls a week.
Want a plan for your business first? Get your Backlink Gameplan.
The 4 Home Assistant tools Hermes uses
| Tool | What it does |
|---|---|
| ha_list_entities | Lists your devices and sensors |
| ha_get_state | Reads the current state of one entity |
| ha_list_services | Shows what actions are available |
| ha_call_service | Runs an action, like turning a light on |
How to make Hermes watch your home
By default Hermes doesn’t get any events. You choose what it watches under platforms.homeassistant.extra in your config:
platforms:
homeassistant:
extra:
watch_domains: [binary_sensor, climate]
watch_entities: [cover.garage_door]
ignore_entities: [sensor.noisy_power_meter]
cooldown_seconds: 30
- watch_domains: whole types of device to watch.
- watch_entities: single devices to watch.
- watch_all: watch everything (can be noisy).
- ignore_entities: skip chatty sensors.
- cooldown_seconds: gap between alerts for the same entity (default 30).
You can also send scheduled jobs to Home Assistant with deliver: homeassistant, for example a morning summary of your home.
Is it safe to let an AI control my home?
Hermes blocks the risky Home Assistant domains by default: shell_command, command_line, python_script, pyscript, hassio and rest_command. That stops it running commands on your server.
Good habits: start with lights and climate only, keep door locks and alarms out until you trust the setup, and watch the notifications for a week.
Want this set up for you instead of doing it yourself? Get your Backlink Gameplan →
Other ways to use Hermes with Home Assistant
- Voice: the community Hermes voice integration lets Home Assistant’s Assist use Hermes as its conversation agent.
- Run Hermes inside HA: the community Hermes Home Assistant add-on runs Hermes on your HA box.
- Chat apps: connect Hermes to Telegram or WhatsApp too, and control your home from your phone.
These are community projects, not official Nous Research add-ons.
Common errors and fixes
| Problem | Fix |
|---|---|
| 401 Unauthorized | Your token isn’t a long-lived access token. Create a new one in your HA profile |
| Can’t reach Home Assistant | Check HASS_URL. Test it with curl -H "Authorization: Bearer <token>" <url>/api/, which should return API running |
| No events arrive | Nothing is forwarded by default. Add watch_domains or watch_entities |
| Too many alerts | Add noisy sensors to ignore_entities or raise cooldown_seconds |
| A command is refused | That domain is blocked for safety |
My verdict on Hermes Agent Home Assistant
This is one of the most fun Hermes setups you can do. It takes about 10 minutes, the safety defaults are sensible, and watching events turns Hermes from a chatbot into a real home assistant. Start small with lights and climate, then add more. That’s all you need to get going with Hermes Agent Home Assistant.
About Julian Goldie
I’m Julian Goldie — founder of Goldie Agency and the AI Profit Boardroom. I test new AI agents almost every day for 432K+ YouTube subscribers and run Hermes, OpenClaw, OpenCode, Claude and Codex side by side in my own Agent OS. Get your Backlink Gameplan or join the AI Profit Boardroom.
FAQ: hermes agent home assistant
Does Hermes Agent work with Home Assistant?
Yes. Hermes has an official Home Assistant plugin you install with hermes plugins install homeassistant.
What do I need to connect Hermes to Home Assistant?
A Home Assistant long-lived access token (HASS_TOKEN) and your Home Assistant URL (HASS_URL).
What can Hermes control in Home Assistant?
Lights, switches, climate, covers, media players, fans, scenes and scripts.
Can Hermes run shell commands through Home Assistant?
No. shell_command, command_line, python_script, pyscript, hassio and rest_command are blocked.
Why does Hermes not react to my sensors?
No events are forwarded by default. Set watch_domains or watch_entities in your config.
Can I use Hermes as my Home Assistant voice assistant?
Yes, with the community hermes-voice-ha-integration, which makes Hermes the conversation agent for Assist.
Ready to put Hermes to work in your business? Join the AI Profit Boardroom for the Agent OS, setup training and daily updates.
Or get your Backlink Gameplan and we’ll map out your setup.
Starting from zero? Get the free AI course and community.
Join the AI Profit Boardroom →Get Your Backlink Gameplan →Get the FREE AI Course + Community →
Related reading
Last updated November 2026. This page is a living guide to hermes agent home assistant — the facts here move fast and it is updated as they do.
