This guide shows you how to set up Hermes Agent Home Assistant control in about ten minutes. You install one official plugin, paste in one token, and start the gateway. After that you can type "turn off the kitchen lights" in Telegram or the terminal, and Hermes does it. Hermes can also watch your sensors and act when a door opens.
📺 Watch: Hermes Agent OS Can Automate EVERYTHING?! 🤯
🔥 Get the Agent OS as a free bonus: AI Profit Boardroom members get the full Agent OS zip, prompt libraries, daily tutorials and weekly live coaching calls. → Get inside
Everything below comes from the official Hermes Agent docs from Nous Research, checked on 19 November 2026. If you get stuck, the AI Profit Boardroom has weekly live calls where you can share your screen and get it fixed.
What Hermes Agent Home Assistant Actually Does
Home Assistant support comes from the official homeassistant plugin. Nous Research maintains it in the hermes-official-plugins repo. It is not part of Hermes core, so you install it yourself. The plugin gives you two things:
- Smart home tools. Four tools the agent can call to read and control your devices through the Home Assistant REST API.
- A gateway platform. Hermes connects to Home Assistant over a WebSocket and listens for state changes. When something you care about changes, Hermes gets a message and can act on it.
So you get both directions. You can tell Hermes what to do, and Home Assistant can tell Hermes what just happened.
What You Need Before You Start
- Hermes Agent installed and working on your computer or server.
- A running Home Assistant instance you can log in to.
- The two on the same network, or Home Assistant reachable from wherever Hermes runs.
- Admin rights in Home Assistant so you can create a token.
One Mac tip from the docs: if your Hermes gateway runs as a launchd service, older versions could not reach devices on your home network. Running hermes gateway install on a current version refreshes the service so it can reach LAN hosts like Home Assistant.
Step 1: Install the Plugin
Open a terminal and run:
hermes plugins install homeassistant
Plugins are installed per profile. If you use more than one Hermes profile, install it in each one you want:
hermes -p your-profile plugins install homeassistant
Upgrading from an older release that bundled Home Assistant? The docs say you don't need to do anything. hermes update installs the plugin for any profile that was already using it, and your settings carry over.
Step 2: Create a Long-Lived Access Token
- Open Home Assistant in your browser.
- Click your name in the sidebar to open your Profile.
- Scroll to Long-Lived Access Tokens.
- Click Create Token and name it something like "Hermes Agent".
- Copy the token. You only see it once.
Short-lived browser session tokens will not work. If you get a "401 Unauthorized" error later, this is almost always the reason.
Step 3: Add the Token to Hermes
Add these lines to ~/.hermes/.env:
HASS_TOKEN=your-long-lived-access-token
HASS_URL=http://192.168.1.100:8123
HASS_HOME_CHANNEL=mobile_app_my_phone
- HASS_TOKEN is required.
- HASS_URL is optional. If you leave it out, Hermes uses
http://homeassistant.local:8123. - HASS_HOME_CHANNEL is optional. It is the default notify target, such as your phone's Home Assistant app.
Once the token is set and the plugin is installed, the Home Assistant toolset turns on by itself. Keep this file private. Never paste the token into a chat or a public repo.
Step 4: Start the Gateway
hermes gateway
Home Assistant now shows up as a connected platform next to Telegram, Discord or anything else you have set up. Ask Hermes "list all lights in the living room" to test it.
Want the exact setup we use to run agents like this every day? The AI Profit Boardroom gives you the full Agent OS, step-by-step video tutorials and live coaching calls.
📺 Watch: Stop Finding Leads Manually! Use Hermes Agent
The Four Smart Home Tools
| Tool | What it does | Try saying |
|---|---|---|
| ha_list_entities | Lists devices, filtered by type (light, switch, climate, sensor) or room | "List all lights in the kitchen" |
| ha_get_state | Gets the full state of one device, like brightness or temperature | "What is the thermostat set to?" |
| ha_list_services | Shows what actions each device type supports | "What can I do with climate devices?" |
| ha_call_service | Controls a device: turn on, turn off, set temperature, open a cover | "Set the thermostat to 22 degrees in heat mode" |
You don't need to remember the tool names. You talk in plain words and Hermes picks the right tool.
Let Hermes React to Events
This is the part most people miss. By default, no events are sent to Hermes. You have to tell it what to watch, or every state change is silently dropped. Add a filter in ~/.hermes/config.yaml under the Home Assistant platform's extra section:
platforms:
homeassistant:
enabled: true
extra:
watch_domains:
- climate
- binary_sensor
- alarm_control_panel
watch_entities:
- sensor.front_door_battery
ignore_entities:
- sensor.uptime
cooldown_seconds: 30
- watch_domains: only watch these device types.
- watch_entities: only watch these exact devices.
- watch_all: get every change. The docs say this is not recommended for most homes.
- ignore_entities: always skip noisy sensors like CPU use or uptime.
- cooldown_seconds: the gap between events for the same device. The default is 30.
The docs suggest starting with climate, binary sensors and the alarm panel. Those cover the most useful automations. Add more later.
Where Hermes Replies
When Hermes answers an event, the reply lands as a persistent notification in Home Assistant, titled "Hermes Agent". Scheduled jobs and webhooks can also deliver to Home Assistant:
deliver: homeassistant:mobile_app_my_phone
deliver: homeassistant
The second form needs HASS_HOME_CHANNEL set. That means you can ask Hermes to "check every night at 10pm that all doors are locked and tell my phone", and the answer arrives as a phone notification.
📺 Watch: Hermes Agent: The 6 Levels Explained!
Three Automations to Copy
1. Morning routine
Say "start my morning routine". Hermes turns on the bedroom light at half brightness, sets the thermostat to 22 and turns on the kitchen speaker. This is the example from the official docs.
2. Security check
Ask "is the house secure?". Hermes checks your door and window sensors, the alarm panel and your locks, then reports back in one line, like "All doors closed, alarm armed, all locks engaged."
3. Front door alert
With binary sensors on your watch list, the front door opening sends Hermes an event. Hermes can check the sensor, turn on the hallway light and send you a note: "Front door opened. Hallway lights turned on."
You can also run these on a schedule. Hermes has a built-in cron system you control in plain language, so "every weekday at 7am, run my morning routine" works too.
Safety Rules Built In
Hermes blocks the Home Assistant service types that could run code on your server. These are blocked:
- shell_command and command_line (run commands)
- python_script and pyscript (run scripts)
- hassio (add-on control, host shutdown and reboot)
- rest_command (HTTP requests from the Home Assistant server)
Device names are also checked against a strict pattern to stop injection tricks. Even so, give the token only to the Hermes profile that needs it, and think twice before letting an agent control locks or alarms without a human check.
Fixes for Common Problems
- Tools are missing. Run
hermes plugins list. If the plugin isn't there, install it and restart the gateway. - Token not picked up. Check the .env file is in the active profile's home, with no stray quotes. Restart the gateway after any change.
- 401 Unauthorized. Make a new Long-Lived Access Token from your Profile page.
- No events arriving. Add at least one of watch_domains, watch_entities or watch_all.
Which Model Should Run Your Smart Home?
Smart home commands are short, so a fast, cheap model is usually fine. For longer jobs, like a nightly house report, a stronger model helps. We compare models on real tasks on Goldie Bench if you want to pick based on data. And if you also want Hermes in your chat apps, see our Hermes Agent Telegram guide.
That is the full Hermes Agent Home Assistant setup: plugin, token, gateway, filters. Start with one room and one sensor, then grow it. To build the rest of your agent stack with us, join the AI Profit Boardroom.
FAQ
Is the Hermes Agent Home Assistant plugin official?
Yes. The homeassistant plugin is maintained by Nous Research in the hermes-official-plugins repo. It is installed from the plugin catalog, not bundled in Hermes core.
Do I need to pay for Home Assistant to use it?
No paid add-on is needed. You need a Home Assistant instance Hermes can reach and a Long-Lived Access Token.
Why is Hermes not reacting to my sensors?
By default no events are forwarded. Add watch_domains, watch_entities or watch_all to the Home Assistant platform's extra settings in config.yaml, then restart the gateway.
Can Hermes run shell commands through Home Assistant?
No. The shell_command, command_line, python_script, pyscript, hassio and rest_command domains are blocked to stop code running on your Home Assistant host.
Can I control Home Assistant from my phone with Hermes?
Yes. Connect Hermes to a chat app like Telegram or WhatsApp and message it from your phone. Replies can also go to your phone through the Home Assistant mobile app as a notify target.











