What do I need to connect this MCP server to Home Assistant?

You need your Home Assistant base URL (HA_URL) and a long-lived access token (HA_TOKEN). For file management over SSH, optionally provide HA_SSH_HOST, SSH credentials, and a private key path or password.

Can I manage Home Assistant files remotely with this server?

Yes, if you configure SSH variables (HA_SSH_HOST, HA_SSH_USER, HA_SSH_KEY_PATH or HA_SSH_PASSWORD). SSH access requires root user permissions and defaults to port 22.

What Home Assistant resources can I control through this MCP server?

You can manage dashboards, automations, add-ons, and files. The server provides full programmatic control over these Home Assistant components via the MCP protocol.

How do I generate a long-lived access token for HA_TOKEN?

In Home Assistant, go to your user profile settings, scroll to the bottom, and create a new long-lived access token. Copy it and set it as the HA_TOKEN environment variable.

Is SSH file access required to use this server?

No, SSH is optional. You can control dashboards, automations, and add-ons with just HA_URL and HA_TOKEN. SSH variables are only needed if you want to manage Home Assistant files remotely.

MCP ServerSTDIOOfficialv1.0.6

Home Assistant MCP Server

Control Home Assistant instances programmatically—manage dashboards, automations, add-ons, and files via MCP. For developers integrating Home Assistant into AI workflows or building custom automation tools.

io.github.jarahkon/hass-mcp-server

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

2 required env vars

What the Home Assistant MCP server does

How models use it and what it is built for.

Connect to Home Assistant

Local install — runs as a subprocess.

npx @jarahkon/hass-mcp-server@1.0.6

Environment variables

Configuration this server reads at startup.

HA_URLRequired
Home Assistant base URL (e.g. http://homeassistant.local:8123)
HA_TOKENRequiredSecret
Home Assistant long-lived access token
HA_SSH_HOST
SSH hostname for file management (optional)
HA_SSH_PORT
SSH port (default: 22)
HA_SSH_USER
SSH username (must be root)
HA_SSH_KEY_PATH
Path to SSH private key
HA_SSH_PASSWORDSecret
SSH password (alternative to key)

Resources

Where to find authoritative docs and source for Home Assistant.

Source repository

Example prompts for Home Assistant

Paste any of these into Agent Studio after connecting Home Assistant.

List all automations in my Home Assistant instance and show which ones are enabled
Create a new dashboard card that displays temperature and humidity sensors
What add-ons are currently installed and what is their status
Explain how to configure the HA_SSH_HOST variable for remote file access

Home Assistant MCP server — FAQ

Common questions about connecting and running Home Assistant.

What do I need to connect this MCP server to Home Assistant?
You need your Home Assistant base URL (HA_URL) and a long-lived access token (HA_TOKEN). For file management over SSH, optionally provide HA_SSH_HOST, SSH credentials, and a private key path or password.
Can I manage Home Assistant files remotely with this server?
Yes, if you configure SSH variables (HA_SSH_HOST, HA_SSH_USER, HA_SSH_KEY_PATH or HA_SSH_PASSWORD). SSH access requires root user permissions and defaults to port 22.
What Home Assistant resources can I control through this MCP server?
You can manage dashboards, automations, add-ons, and files. The server provides full programmatic control over these Home Assistant components via the MCP protocol.
How do I generate a long-lived access token for HA_TOKEN?
In Home Assistant, go to your user profile settings, scroll to the bottom, and create a new long-lived access token. Copy it and set it as the HA_TOKEN environment variable.
Is SSH file access required to use this server?
No, SSH is optional. You can control dashboards, automations, and add-ons with just HA_URL and HA_TOKEN. SSH variables are only needed if you want to manage Home Assistant files remotely.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 60+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio