Field notes · AI agents, Hermes & Claude Code By Julian Goldie

Hermes Agent Home Assistant Setup: Install the Plugin, Wire the Token and Filter the Events

The exact commands, the env vars, the event filters and the four tools, straight from the Nous Research docs.

Get The AI Profit Stack Join AIPB →
  • 01 1,000+ done-for-you AI agent workflows
  • 02 5 live coaching calls / week with me
  • 03 7-day refund, cancel anytime
  • 04 3,400+ AI operators inside

The Hermes Agent Home Assistant connection runs through one official plugin, and you can have it live in about ten minutes.

Install it, paste a long-lived token into your env file, start the gateway, then tell it which devices to watch.

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

If you want AI agents running your SEO and lead flow the same way, get your Backlink Gameplan with my team, or try Polar Rank free for 3 days.

Everything below comes from the Hermes Home Assistant docs and the plugin source on GitHub.

What the plugin gives you

The plugin is maintained by Nous Research in the hermes-official-plugins repo and is not part of Hermes core.

It adds two things at once.

  • A gateway platform that subscribes to state changes over WebSocket and forwards matching events to the agent.
  • A smart home toolset called homeassistant with four LLM-callable tools that talk to the REST API.

One token switches on both halves.

Step 1: install the plugin per profile

Run this on the machine that runs Hermes:

hermes plugins install homeassistant

Plugins install per profile, so a second profile needs its own install:

hermes -p <profile> plugins install homeassistant

The plugin declares its own aiohttp dependency.

The old hermes-agent[homeassistant] pip extra is gone, so skip any tutorial that still tells you to pip install it.

Upgrading from a release that bundled Home Assistant needs no action: hermes update installs the plugin for profiles that already used it.

Step 2: create the long-lived access token

In Home Assistant, open your Profile, scroll to Long-Lived Access Tokens and click Create Token.

Name it something you will recognise later, like Hermes Agent, and copy it once.

Short-lived UI session tokens will not work, which is the cause of most 401 errors.

Home Assistant explains token types on its authentication page.

Step 3: write the env file

Add these lines to ~/.hermes/.env under the active profile home:

HASS_TOKEN=your-long-lived-access-token
HASS_URL=http://192.168.1.100:8123
HASS_HOME_CHANNEL=mobile_app_my_phone

HASS_URL is optional and defaults to http://homeassistant.local:8123.

HASS_HOME_CHANNEL is the default notify target for a bare deliver: homeassistant line in cron jobs.

With the plugin installed, the toolset switches on automatically once HASS_TOKEN is set.

Step 4: start the gateway and check it connected

hermes gateway

Home Assistant then shows up as a connected platform next to Telegram, Discord or whatever else you run.

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

Env changes only load when the process starts, so restart the gateway after every edit.

🔥 Want the whole agent stack set up for you, not just the smart home piece? Inside the AI Profit Boardroom you get step-by-step video trainings, the installable Agent OS, four coaching calls a week and 3,400+ members building with Hermes. → Join the AI Profit Boardroom

Step 5: set event filters or nothing arrives

This is the gotcha that catches almost everyone.

By default no events are forwarded at all, and Hermes logs a warning and drops every state change.

Add at least one filter under the platform's extra block in ~/.hermes/config.yaml:

platforms:
  homeassistant:
    enabled: true
    extra:
      watch_domains:
        - climate
        - binary_sensor
        - alarm_control_panel
      watch_entities:
        - sensor.front_door_battery
      ignore_entities:
        - sensor.uptime
        - sensor.cpu_usage
      cooldown_seconds: 30
SettingDefaultWhat it controls
watch_domainsnoneOnly these entity domains reach the agent
watch_entitiesnoneOnly these exact entity IDs reach the agent
watch_allfalseEvery state change, which floods most setups
ignore_entitiesnoneAlways dropped, checked before the other filters
cooldown_seconds30Minimum gap between events for one entity

The docs suggest climate, binary_sensor and alarm_control_panel as the starting set, then adding domains as you need them.

The four tools and what they call

ToolJobExample ask
ha_list_entitiesList entities, filter by domain or areaList all lights in the living room
ha_get_stateFull state and attributes for one entityWhat is climate.thermostat set to?
ha_list_servicesShow the actions a domain acceptsWhat services exist for climate devices?
ha_call_serviceRun an action on a deviceSet the thermostat to 22 in heat mode

A thermostat change resolves to a call like this one:

ha_call_service(domain="climate", service="set_temperature",
  entity_id="climate.thermostat", data={"temperature": 22, "hvac_mode": "heat"})

If Tool Search is on, the ha_* tools sit behind tool_search and tool_call like every other plugin tool.

How events read once they arrive

The adapter turns raw state changes into plain sentences by domain.

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

  • climate changes read like "HVAC mode changed from 'off' to 'heat'" with current and target values.
  • binary_sensor changes read as triggered or cleared.
  • light, switch and fan changes read as turned on or turned off.

The agent's replies land in Home Assistant as persistent notifications titled Hermes Agent.

Route cron jobs and webhooks to your phone

Scheduled jobs and webhook routes can deliver straight to Home Assistant:

deliver: homeassistant:mobile_app_my_phone
deliver: homeassistant

The bare form needs HASS_HOME_CHANNEL set.

Pair this with the cron docs to get a morning house report pushed to your phone, and with webhook routes for events from other services.

Security limits you cannot switch off

The tools block service domains that could run code on the Home Assistant host.

  • shell_command and command_line
  • python_script and pyscript
  • hassio, which covers add-on control and host shutdown
  • rest_command, which could make HTTP requests from the HA server

Entity IDs are also checked against a strict pattern before any call goes out.

Connection behaviour worth knowing

  • The WebSocket keeps a 30-second heartbeat for live events.
  • Reconnects back off from 5 to 10 to 30 to 60 seconds.
  • Outbound notifications use a separate REST session so they never fight the WebSocket.
  • Home Assistant events are always authorised, because the token authenticates the link and there is no human sender to pair.

📞 Running a local business and want this kind of automation behind your SEO? Get your Backlink Gameplan and my team will map where agents save you hours and where search traffic is leaking, or try Polar Rank free for 3 days. Backlink Gameplan or try Polar Rank free for 3 days

Three automations the docs walk through

The morning routine is a chain of three service calls: bedroom light to brightness 128, thermostat to 22, kitchen speaker on.

The security check reads every binary_sensor, the alarm panel state and every lock, then sends one line back.

The reactive one starts from an event: the front door triggers, the agent reads the sensor, turns on the hallway light and sends a note.

Build them in that order, because each one adds a new moving part.

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

The first only writes, the second only reads, and the third needs your watch list working.

Run the gateway as a service

Running hermes gateway in a terminal is fine for testing, but the connection dies when the terminal closes.

The gateway docs give two longer-lived options.

hermes gateway install
sudo hermes gateway install --system

The first installs a user service; the second is Linux only and starts at boot.

Run hermes gateway status if you suspect two copies are running, because duplicate gateways cause duplicate replies.

Display settings for notifications

The Home Assistant platform uses the minimal display defaults.

That means no tool-progress lines and no streaming chatter in your notification panel, just the final message.

If you want more detail while debugging, override it under display.platforms.homeassistant in config.yaml, then switch it back.

Multi-profile setups

Each Hermes profile keeps its own plugins, so a work profile and a home profile can run separately.

Install the plugin with hermes -p home plugins install homeassistant and keep HASS_TOKEN only in that profile's .env.

That way the agent that handles your client work never sees your house.

If you later remove the plugin from a profile with hermes plugins remove homeassistant, it stays removed and is not reinstalled on update.

Upgrade behaviour in detail

Profiles that already used Home Assistant get the plugin from the catalog during hermes update.

If that step could not run, Hermes installs it the first time the profile starts, as long as security.allow_lazy_installs is on.

A failed attempt, for example when the catalog is unreachable, retries at most once an hour on start, while hermes update always retries.

Your old HASS_TOKEN, HASS_URL, platform keys, toolset name and cron deliver syntax all carry over unchanged.

Other ways people connect the two

The official plugin is the clean route, but the results for this search show a few other patterns.

  • Community custom integrations posted in Home Assistant forums go the other way, letting HA talk to Hermes. Treat anything labelled alpha as a test build.
  • The API server exposes Hermes as an OpenAI-compatible endpoint on port 8642, so any client that speaks that format can reach it.
  • A Home Assistant automation can POST to a Hermes webhook route, which then runs the agent with a prompt template.

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

Start with the plugin; reach for the others only when you need HA to start the conversation.

Writing prompts the tools understand

The tools match areas against friendly names, so name your rooms clearly in Home Assistant first.

"List all lights in the living room" works because ha_list_entities can filter by the area string.

For changes, give the agent the entity ID when you know it, such as light.living_room, and it skips a lookup call.

For colour and brightness, plain words work: the docs show a request for blue at 50% brightness turning into brightness 128 and color_name blue.

When a request touches several devices, ask the agent to list the calls it will make before it runs them.

That one habit catches wrong entity IDs before they switch the wrong thing.

Picking domains for the watch list

Think in terms of what you would want a message about.

climate covers thermostats and HVAC mode changes, which is useful for comfort and for spotting a heating fault.

binary_sensor covers doors, windows, motion and leak sensors, which is where most security value sits.

alarm_control_panel tells you when the alarm arms, disarms or triggers.

light and switch are usually noise, so leave them out unless a specific light matters.

Add single entities with watch_entities when only one device in a busy domain matters, such as a front door battery sensor.

Logs to check when debugging

The gateway logs a warning at startup when no filter is set, so read the first lines after every restart.

Connection drops show up as reconnect attempts with the backoff times above.

If a service call fails, the error usually names the domain or entity, which tells you whether it was blocked, missing or misspelled.

Keep the gateway running in a terminal while you test, then move it to a service once it is stable.

Troubleshooting checklist

  1. Platform or tools missing: run hermes plugins list in the active profile and reinstall if it is absent.
  2. Env not picked up: check the .env sits under the active profile home with no stray quotes around the URL or token.
  3. 401 Unauthorized: create a fresh long-lived token and confirm HASS_URL includes the scheme and port.
  4. Test reachability from the Hermes host with curl against /api/ and look for the API running message.
  5. Events silent: add watch_domains or watch_entities, then restart the gateway.

For more agent builds like this, the AI Profit Boardroom has the full Hermes training library.

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

FAQ: Hermes Agent Home Assistant Setup

Does Hermes Agent support Home Assistant out of the box?

Yes, through the official homeassistant plugin from the plugin catalog. Install it with hermes plugins install homeassistant and set HASS_TOKEN.

Why does my Hermes Agent ignore Home Assistant events?

No events are forwarded until you set watch_domains, watch_entities or watch_all in config.yaml. Add a filter and restart the gateway.

Which token does the plugin need?

A Long-Lived Access Token created from your Home Assistant user profile. Short-lived session tokens return 401 errors.

Can Hermes run shell commands through Home Assistant?

No. The plugin blocks shell_command, command_line, python_script, pyscript, hassio and rest_command service domains.

Where do Hermes replies show up in Home Assistant?

As persistent notifications titled Hermes Agent, or on a notify target such as your phone when a cron job uses deliver: homeassistant.

📺 Video notes + links to the tools 👉

🎥 Learn how I make these videos 👉

🆓 Get a FREE AI Course + Community + 1,000 AI Agents 👉

About Julian

I'm Julian Goldie, an SEO entrepreneur, author and founder of the AI Profit Boardroom, which has 3,400+ members.

I help business owners scale with AI agents, automation and SEO.

  • I've built a 7-figure SEO and link building agency, Goldie Agency, with a team of 70+ SEO experts.
  • I've grown a YouTube channel to 400,000+ subscribers.
  • I wrote "Link Building Mastery".
  • My Udemy courses have taught over 29,000 students.

→ Get my best AI training inside the AI Profit Boardroom

Install the plugin, set your filters and run the morning-routine test tonight.

Then get your Backlink Gameplan if you want the same agent thinking pointed at your rankings, and keep this page open as your Hermes Agent Home Assistant checklist, or try Polar Rank free for 3 days.

§ Member reviews

What members say about the AI Profit Boardroom

Read the member reviews on Skool →
Ahmad Bukhari: Julian doesn't gatekeep. That's why I'd recommend this group. He's extremely active here, sharing what's working right now and jumping in to help anyone who's stuck. If he can give it away, he does. He keeps the vibe positive and pushes everyone to help each other. His challenges reward members for getting people unstuck, so the whole room shares knowledge, not just him. Want a generous, positive place to learn AI and actually use it? This is it. Thanks Julian!
Ahmad Bukhari
Julian doesn't gatekeep. That's why I'd recommend this group. He's extremely active here, sharing what's working right now and jumping in to help anyone who's stuck. If he can give it away, he does. He keeps the vibe positive and pushes everyone to help each other. His challenges reward members for getting people unstuck, so the whole room shares knowledge, not just him. Want a generous, positive place to learn AI and actually use it? This is it. Thanks Julian!

Still a paying member after 1 month

Jay Parsons: There are so many helpful members in this amazing community ready to help out with suggestions and solutions whenever someone asks a question. I am amazed at the progress I have made in learning AI. I came here to learn how to use AI better and apply what I learned to my business. I am learning so much more than I even dreamed of. I have built an Agentic OS and use it every day, and I have no background in coding. There are an incredible amount of useful tutorials on everything AI.
Jay Parsons
There are so many helpful members in this amazing community ready to help out with suggestions and solutions whenever someone asks a question. I am amazed at the progress I have made in learning AI. I came here to learn how to use AI better and apply what I learned to my business. I am learning so much more than I even dreamed of. I have built an Agentic OS and use it every day, and I have no background in coding. There are an incredible amount of useful tutorials on everything AI.

Still a paying member after 11 months

Brian O'Connor: At 47, with 30 years in sales and finance, embracing AI was exciting but overwhelming. While building a business to help others adopt AI, I found myself chasing tools and fearing I was falling behind. Julian and the AI Profit Boardroom helped me refocus through practical, personalized advice and a supportive community. I now feel more confident adapting to change while staying focused on my goals. Thank you, Julian, for bringing this community together!
Brian O'Connor
At 47, with 30 years in sales and finance, embracing AI was exciting but overwhelming. While building a business to help others adopt AI, I found myself chasing tools and fearing I was falling behind. Julian and the AI Profit Boardroom helped me refocus through practical, personalized advice and a supportive community. I now feel more confident adapting to change while staying focused on my goals. Thank you, Julian, for bringing this community together!

Still a paying member after 2 months

Neil Martin: This is a truly amazing community, thanks in no small part to Julian's prodigious output and tireless efforts to provide value to his subscribers. Nothing is too much trouble for him. If you ask a question it gets answered in short order usually with a custom video. I have been in quite a few groups and this level of service is unparalleled. If you are serious about getting an AI education, you need to be in this group!
Neil Martin
This is a truly amazing community, thanks in no small part to Julian's prodigious output and tireless efforts to provide value to his subscribers. Nothing is too much trouble for him. If you ask a question it gets answered in short order usually with a custom video. I have been in quite a few groups and this level of service is unparalleled. If you are serious about getting an AI education, you need to be in this group!

Still a paying member after 7 months

Crystal Hill: AIPB has inspired me to go beyond learning AI as individual tools, skills, and prompts, and start thinking in terms of larger systems. What I really appreciate is how responsive Julian is and how quickly the material evolves with the technology. You’re being exposed to the right tools and ideas as they emerge. AIPB has given me the confidence to learn, experiment, build, and think much bigger about what’s really possible with AI.
Crystal Hill
AIPB has inspired me to go beyond learning AI as individual tools, skills, and prompts, and start thinking in terms of larger systems. What I really appreciate is how responsive Julian is and how quickly the material evolves with the technology. You’re being exposed to the right tools and ideas as they emerge. AIPB has given me the confidence to learn, experiment, build, and think much bigger about what’s really possible with AI.

Still a paying member after 5 months

Maurice Morrison: AI Profit Board Room has been a game-changer. The insights are practical, timely, and focused on turning AI into real business results—not just theory or hype. The community is supportive, the guidance is clear, and I leave every session with ideas I can actually apply. If you’re serious about using AI to grow smarter and move faster, this is absolutely worth joining.
Maurice Morrison
AI Profit Board Room has been a game-changer. The insights are practical, timely, and focused on turning AI into real business results—not just theory or hype. The community is supportive, the guidance is clear, and I leave every session with ideas I can actually apply. If you’re serious about using AI to grow smarter and move faster, this is absolutely worth joining.

Still a paying member after 2 months

Jeremy Murdock: I have truly enjoyed my experience here. The group of folks on the calls is quite diverse and I find it comforting to know that I am not the only one going through the changes that are happening at a faster and faster pace. I have chosen to embrace the change and go full force into integrating AI and what I have learned form the group and Julian. I am also impressed and appreciative that he actually takes the time to help with challenges I have along the way and get involved personally!
Jeremy Murdock
I have truly enjoyed my experience here. The group of folks on the calls is quite diverse and I find it comforting to know that I am not the only one going through the changes that are happening at a faster and faster pace. I have chosen to embrace the change and go full force into integrating AI and what I have learned form the group and Julian. I am also impressed and appreciative that he actually takes the time to help with challenges I have along the way and get involved personally!

Still a paying member after 10 months

Michael Lovitch: I have been a part of a million ai groups in Skool for years now. They are all okay and have helped, but usually they get out of date and don't offer real service to help you through especially at the beginning. This group is different, Julian actually answers questions which is crazy! And although ai marketing moves at the speed of light, they stay current and actually help you keep up… Highly recommended!
Michael Lovitch
I have been a part of a million ai groups in Skool for years now. They are all okay and have helped, but usually they get out of date and don't offer real service to help you through especially at the beginning. This group is different, Julian actually answers questions which is crazy! And although ai marketing moves at the speed of light, they stay current and actually help you keep up… Highly recommended!

Still a paying member after 3 months

Hoebing Lo: I don't know of any other community that is as active and sharing. Julian is a star and he answers so many questions in lightning speed. If you want a great place to start with AI here it is. No question too simple. No workflow too complicated. The community is about action and results not education so if you are looking to win at AI then come for the ride of a lifetime!
Hoebing Lo
I don't know of any other community that is as active and sharing. Julian is a star and he answers so many questions in lightning speed. If you want a great place to start with AI here it is. No question too simple. No workflow too complicated. The community is about action and results not education so if you are looking to win at AI then come for the ride of a lifetime!

Still a paying member after 5 months

Darren Wagstaff: Very responsive... great personal support (not an ai chat bot). Very clear straight forward trainings in easy to understand actionable language. I'm in numerous Skool groups but this one has the most human and real community by far. No question gets ignored. You never fell like just another number. It's great to see so many members getting great results with Ai.
Darren Wagstaff
Very responsive... great personal support (not an ai chat bot). Very clear straight forward trainings in easy to understand actionable language. I'm in numerous Skool groups but this one has the most human and real community by far. No question gets ignored. You never fell like just another number. It's great to see so many members getting great results with Ai.

Still a paying member after 2 months

Rod Martin: 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.
Rod Martin
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.

Still a paying member after 5 months

Yosuke Sato: 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!
Yosuke Sato
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!

Still a paying member after 19 months

⚑ Next step

Ready to run AI agents that actually do the work?

Join 3,400+ operators inside the AI Profit Boardroom. Get 1,000+ plug-and-play AI agent workflows, 5 coaching calls a week, and a community that holds you accountable.

Join The AI Agent Community →

7-day no-questions refund · Cancel anytime

Found this useful? Get more of this site in your Google.

One tap adds us as a preferred source — Google then shows you our posts more often in Search, Top Stories, and AI Overviews.

← Back to all posts