Hermes Agent + Home Assistant: Control Your Smart Home From Chat

Julian Goldie — founder, AI Profit Boardroom
By Julian Goldie · 8 min read
Get The AI Profit Stack Join AIPB →
🎯 1,000+ done-for-you AI agent workflows 📅 4 live coaching calls every week 🛡️ 7-day refund + 30-day ROI guarantee 👥 3,400+ AI operators inside

Want your AI agent to run your smart home? This is the plain-English setup for Hermes Agent Home Assistant. You add the official plugin, give it a Home Assistant token, and run the gateway. Then Hermes can switch lights, change the heating and react to sensor events, all from a chat message.

📺 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:

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

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

  1. Open Home Assistant in your browser.
  2. Click your name in the sidebar to open your Profile.
  3. Scroll to Long-Lived Access Tokens.
  4. Click Create Token and name it something like "Hermes Agent".
  5. 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

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

ToolWhat it doesTry saying
ha_list_entitiesLists devices, filtered by type (light, switch, climate, sensor) or room"List all lights in the kitchen"
ha_get_stateGets the full state of one device, like brightness or temperature"What is the thermostat set to?"
ha_list_servicesShows what actions each device type supports"What can I do with climate devices?"
ha_call_serviceControls 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

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:

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

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.

Start small: one light, one sensor, one daily check. Once that works, Hermes Agent Home Assistant control becomes a real assistant for your home. For the full workflows and live help, get inside 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.

What members say about the AI Profit Boardroom

Read all 114 reviews on Skool →

★ 4.9 out of 5 from 114 member reviews on Skool

Yosuke Sato, AI Profit Boardroom member review (5 stars, paying member for 17 months): The best Skool course you get for AI! I have attended a few Skool courses before, but AI Profit Boardroom is the most active community and has great support from the management team, including Julian! You can get the most up-to-date information and practical implementations in this community. I highly recommend this!Mazzie T, AI Profit Boardroom member review (5 stars, paying member for 10 months): My mind is blown everyday with all the content and the incredible information. So much support and I love the personalised attention and quick responses. The community is great and people are very responsive and helpful.Rene Clayton, AI Profit Boardroom member review (5 stars, paying member for 9 months): The AI Profit Boardroom is a GAME CHANGER people. I could not be more thrilled that I joined!! So much support, more information than you can even consume, a huge value for what the small fee was. I have grown my business, my knowledge and my FUN!. SUCH a fantastic leader and group of humans. I am incredibly honored to be a part of this fantastic group of intelligent humans :-) THANK YOU!Arpiet Malpani, AI Profit Boardroom member review (5 stars, paying member for 8 months): Incredible learning from Julian and team. I started out in march and was able to build end to end SAAS with the help and learning from this group. I am incredibly thankful to Julian for crazy support and prompt response.James Grimm, AI Profit Boardroom member review (5 stars, paying member for 7 months): I asked Julian for help finding local business websites with little to no traffic. Julian was gracious in providing me my personal "how-to" video instruction. Wow, this is the pinnacle of customer service! I am just one of 3,400 subscribers and Julian took the time to help me personally. Thank you Julian for your assistance and outstanding custoemr support and care. James (Jim) GrimmNick Good, AI Profit Boardroom member review (5 stars, paying member for 4 months): I’m part of many AI groups and hands down, what Julian Goldie, has built here…the classroom trainings are amazing, but the community he has created is second to none (the community is worth the cost of joining!). If you’re looking to become the AI expert and build/create something meaningful, then AI Profit Boardroom is for YOU!Steven Gray, AI Profit Boardroom member review (5 stars, paying member for 4 months): Been in awhile. I’m a dad on a factory shift, not a tech bloke. Julian’s lot showed me how to use AI without drowning in tools. Avatar, voice, the workflow thinking — that’s what I needed. If you’re stuck on “where do I start,” this group’s worth it. I always read them.Steve Erickson, AI Profit Boardroom member review (5 stars, paying member for 4 months): I asked Julian a simple question, and he ended up creating a 10-minute video and a guide breaking down in extreme detail what I had asked. Amazing response!Rod Martin, AI Profit Boardroom member review (5 stars, paying member for 3 months): Julian is brilliant, and more prolific than I can keep up with (which is a great thing). His AgentOS is remarkable, and he is THE go-to guy for what you can really do (and not do) with the ever-increasing deluge of new AI upgrades and tools. HIGHLY recommend.Daniel Shulman, AI Profit Boardroom member review (5 stars, paying member for 4 months): Julian is very helpful. He doesn't try sell stuff you dont need and will give you a straight answer to your questions.Rj Herzog, AI Profit Boardroom member review (5 stars, paying member for 5 months): Top notch. If you are searching & searching thinking there is always something better out there.... You just found it. No need to look any further. Goldie covers it all & is super helpful. Can't beat the group either. Really can't recommend this group enough.Jermey Matthews, AI Profit Boardroom member review (5 stars, paying member for 6 months): While he has the capacity to do it, Julian is definitely doing the unscalable things to support his community.

Ready To Join The #1 AI Community?

Join 3,400+ entrepreneurs inside the AI Profit Boardroom. Get the Agent OS, 1,000+ plug-and-play AI agent workflows, daily Q&A with Julian and 4 live coaching calls every week.

Join The AI Profit Boardroom →

7-Day No-Questions Refund • 30-Day ROI Guarantee

← Back to all posts