Hermes Agent
Connect Hermes Agent to your Home Assistant with the Selora Homes skill — MCP access, OAuth 2.0 authentication, and a read-only or read-write scope you choose during consent.
The Selora Homes skill connects Hermes Agent to your Home Assistant through Selora AI’s MCP server. Once added, Hermes can inspect your home, propose automations, and act on your behalf, all through natural language, with the level of access you grant.
Prerequisites
- Home Assistant 2025.1+ with Selora AI installed
- Selora Connect account linked to your Home Assistant instance
- Hermes Agent with the Selora Homes skill enabled
Setup
Add the Selora Homes skill to Hermes and point it at your Selora AI MCP server.
Selora Hub users
Copy your MCP URL from the Selora AI settings panel (under Remote Access & MCP Authentication). It looks like:
https://mcp-<id>.selorabox.com/api/selora_ai/mcp
Replace <id> with the identifier shown in your MCP URL.
Other users
Use your local Home Assistant URL instead:
http://homeassistant.local:8123/api/selora_ai/mcp
If your instance uses a different hostname, IP address, or port, adjust accordingly.
Docker users should use the host machine’s IP instead of homeassistant.local — see
MCP troubleshooting
for details.
Authentication
The skill authenticates via OAuth 2.0 through Selora Connect. On first use, your browser opens to complete the consent flow. Tokens refresh in the background, with no manual management required.
Choose your access level
During the consent flow you choose how much access Hermes gets:
| Scope | What Hermes can do |
|---|---|
| Read-only | Inspect your home: read entities, automations, patterns, and suggestions. No changes. |
| Read-write | Everything read-only can do, plus create, edit, and act on automations and suggestions. |
Pick read-only if you want Hermes to analyze and advise without touching anything. Pick read-write to let it apply changes you approve. You can revoke or re-grant access at any time from Selora Connect; granting a narrower scope later takes effect on the next token refresh.
For alternative authentication methods (Selora AI tokens, HA long-lived tokens), see MCP & Agent Skills — Authentication .
Available Tools
Which tools Hermes can call depends on the scope you granted.
Read-only (available under both scopes)
| Tool | Description |
|---|---|
selora_get_home_snapshot | Retrieve all entities grouped by area |
selora_list_automations | List all automations |
selora_get_automation | View a specific automation’s details |
selora_validate_automation | Validate an automation’s YAML |
selora_list_sessions | Browse session history |
selora_list_patterns | List detected usage patterns |
selora_get_pattern | View a specific pattern’s details |
selora_list_suggestions | Browse proactive suggestions |
Mutating (require read-write scope)
| Tool | Description |
|---|---|
selora_chat | Natural language chat for automation proposals |
selora_create_automation | Create a new automation from a proposal |
selora_accept_automation | Enable a previously created automation |
selora_delete_automation | Remove an automation |
selora_accept_suggestion | Accept a proactive suggestion |
selora_dismiss_suggestion | Dismiss a suggestion |
selora_trigger_scan | Trigger a fresh pattern and suggestion scan |
If you granted read-only access, the mutating tools are not exposed to Hermes at all.
First Steps
Once the skill is connected:
- Ask Hermes to analyze your home — it will call
selora_get_home_snapshot - Ask for an automation proposal and review the YAML before confirming
- Confirm create — new automations are disabled by default (read-write scope required)
- Run
selora_trigger_scanto refresh patterns and suggestions - Browse
selora_list_suggestionsand accept or dismiss as needed
Troubleshooting
See MCP & Agent Skills — Troubleshooting for common issues (connection errors, authentication failures, Docker networking).
If a mutating action is rejected, confirm you granted read-write access during consent. Re-run the OAuth flow from Selora Connect to change scope.
Last modified June 17, 2026: Fix Hermes Agent URL to hermes-agent.nousresearch.com (c809957)