The hass-mcp-server allows for full Home Assistant control through AI agents, enabling management of dashboards, automations, files, and entities without manual configuration.
From the registry: MCP server for full Home Assistant control — dashboards, files, automations, add-ons, and more
Please install the `hass-mcp-server` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Node.js 20+** — Node.js runtime (https://nodejs.org)
- **Home Assistant long-lived access token** — Create one in HA > Profile > Security
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@jarahkon/hass-mcp-server@latest"]
- required environment variables:
- `HA_URL`: Home Assistant base URL (example: `<your-homeassistant-url>`)
- `HA_TOKEN`: Home Assistant long-lived access token (example: `<your-ha-token>`)
- optional environment variables:
- `HA_SSH_HOST`: SSH host for file management tools (example: `<your-ssh-host>`)
- `HA_SSH_PORT`: SSH port (example: `22`)
- `HA_SSH_USER`: SSH username (must be root) (example: `root`)
- `HA_SSH_KEY_PATH`: Path to SSH private key (example: `/path/to/ha_ed25519`)
- `HA_SSH_PASSWORD`: SSH password (alternative to key) (example: `<your-ssh-password>`)
Note: File management tools require SSH access (Advanced SSH & Web Terminal add-on).
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.HA_URLrequiredHome Assistant base URL (e.g. http://homeassistant.local:8123)HA_TOKENrequiredLong-lived access token from Home AssistantManage UniFi Protect cameras, events, recordings, and smart detections via MCP.