mcpbeat Sign in

Home Assistant MCP Server

local only

Home Assistant runs on your own machine — the client starts it, so there is no endpoint to ping. 563 installs a week from npm. Last commit 7 Nov 2026.

Read your Home Assistant's states, areas and history, and run its actions, approving locks first.

Installs per day peak 467 · avg 18
a month agotoday
563
Installs / week
npm · @foreverworks/mcp-home-assistant
2
Stars
0 open issues
7 Nov 2026
Last commit
from GitHub
MIT
License
TypeScript

What the code does

We read the source, 19 h ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add home-assistant -e 'HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL>' -e 'HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE>' -- npx -y @foreverworks/mcp-home-assistant
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "home-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-home-assistant"
      ],
      "env": {
        "HOME_ASSISTANT_TOKEN_FILE": "<HOME_ASSISTANT_TOKEN_FILE>",
        "HOME_ASSISTANT_URL": "<HOME_ASSISTANT_URL>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.home-assistant]
command = "npx"
args = ["-y", "@foreverworks/mcp-home-assistant"]
env = { HOME_ASSISTANT_URL = "<HOME_ASSISTANT_URL>", HOME_ASSISTANT_TOKEN_FILE = "<HOME_ASSISTANT_TOKEN_FILE>" }
.cursor/mcp.json
{
  "mcpServers": {
    "home-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-home-assistant"
      ],
      "env": {
        "HOME_ASSISTANT_TOKEN_FILE": "<HOME_ASSISTANT_TOKEN_FILE>",
        "HOME_ASSISTANT_URL": "<HOME_ASSISTANT_URL>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "home-assistant": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-home-assistant"
      ],
      "env": {
        "HOME_ASSISTANT_TOKEN_FILE": "<HOME_ASSISTANT_TOKEN_FILE>",
        "HOME_ASSISTANT_URL": "<HOME_ASSISTANT_URL>"
      }
    }
  }
}

Put your own values in place of <HOME_ASSISTANT_URL> (The address you open Home Assistant at, such as http://homeassistant.local:8123), <HOME_ASSISTANT_TOKEN_FILE> (Path of a file holding a long-lived access token made in an administrator's Home Assistant profile). The author’s registry entry marks them as required.

Optional settings from the registry entry, left out of the block above: HOME_ASSISTANT_CONFIRM_DOMAINS (Action domains you approve call by call, comma-separated (default lock,alarm_control_panel,cover,valve; none for none)).

Alternatives to Home Assistant

same job, measured the same way
Geolocate Me
by guleki

Give any AI assistant real-time access to your phone's GPS and location history.

answering
Logspot
by logspot

Query your Logspot analytics, companies, and revenue from any AI assistant, and run your actions.

answering
three.ws Home
by nirholas

Read and safely act on a real Home Assistant house: rooms, live state, scenes, gated actions.

30 installs/wk local only
Metodix — training log for coaches
by metodix

Training log for coaches: your AI assistant finds clients, reads history, logs and plans workouts.

answering
Reef
by reefwith

Shared, living memory for you and your people — coves your AI assistant can read and write.

answering
Spellar
by spellar

Read your Spellar meetings, transcripts and action items from an AI assistant, and update them.

answering
S
Softspoken
by softspoken

Lets AI assistants read your Softspoken meetings and tick off, snooze or set due dates on actions.

local only
FounderPulse
by founder-pulse

Your AI assistant reads today's one action to find customers, your context, and logs results.

answering

Home Assistant — questions

Answers built from our own checks of this server.

Why is there no uptime for Home Assistant?
Home Assistant runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @foreverworks/mcp-home-assistant was installed 563 times last week.
How do I connect Home Assistant?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @foreverworks/mcp-home-assistant straight from npm; nothing to host, nothing to sign up for.
How many people use Home Assistant?
The npm package @foreverworks/mcp-home-assistant was installed 563 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Home Assistant open source?
Yes — it is published under the MIT licence, written in TypeScript and 2 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.