MCP server for full Home Assistant control — dashboards, files, automations, add-ons, and more
Connect Runs on your machine
claude mcp add hass-mcp-server -e HA_URL=<HA_URL> -e HA_TOKEN=<HA_TOKEN> -e HA_SSH_HOST=<HA_SSH_HOST> -e HA_SSH_PORT=<HA_SSH_PORT> -e HA_SSH_USER=<HA_SSH_USER> -e HA_SSH_KEY_PATH=<HA_SSH_KEY_PATH> -e HA_SSH_PASSWORD=<HA_SSH_PASSWORD> -- npx -y @jarahkon/[email protected]
{
"mcpServers": {
"hass-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jarahkon/[email protected]"
],
"env": {
"HA_URL": "<HA_URL>",
"HA_TOKEN": "<HA_TOKEN>",
"HA_SSH_HOST": "<HA_SSH_HOST>",
"HA_SSH_PORT": "<HA_SSH_PORT>",
"HA_SSH_USER": "<HA_SSH_USER>",
"HA_SSH_KEY_PATH": "<HA_SSH_KEY_PATH>",
"HA_SSH_PASSWORD": "<HA_SSH_PASSWORD>"
}
}
}
}
{
"mcpServers": {
"hass-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jarahkon/[email protected]"
],
"env": {
"HA_URL": "<HA_URL>",
"HA_TOKEN": "<HA_TOKEN>",
"HA_SSH_HOST": "<HA_SSH_HOST>",
"HA_SSH_PORT": "<HA_SSH_PORT>",
"HA_SSH_USER": "<HA_SSH_USER>",
"HA_SSH_KEY_PATH": "<HA_SSH_KEY_PATH>",
"HA_SSH_PASSWORD": "<HA_SSH_PASSWORD>"
}
}
}
}
{
"servers": {
"hass-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@jarahkon/[email protected]"
],
"env": {
"HA_URL": "<HA_URL>",
"HA_TOKEN": "<HA_TOKEN>",
"HA_SSH_HOST": "<HA_SSH_HOST>",
"HA_SSH_PORT": "<HA_SSH_PORT>",
"HA_SSH_USER": "<HA_SSH_USER>",
"HA_SSH_KEY_PATH": "<HA_SSH_KEY_PATH>",
"HA_SSH_PASSWORD": "<HA_SSH_PASSWORD>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
HA_URLRequired | Home Assistant base URL (e.g. http://homeassistant.local:8123) |
HA_TOKENRequired, secret | Home Assistant long-lived access token |
HA_SSH_HOSTOptional | SSH hostname for file management (optional) |
HA_SSH_PORTOptional | SSH port (default: 22) |
HA_SSH_USEROptional | SSH username (must be root) |
HA_SSH_KEY_PATHOptional | Path to SSH private key |
HA_SSH_PASSWORDOptional, secret | SSH password (alternative to key) |
Details
| Package | @jarahkon/[email protected] (NPM, stdio) |
| First published | 25 Mar 2026 |
| Last updated | 25 Mar 2026 |
| Registry name | io.github.jarahkon/hass-mcp-server |
More files and documents servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
