Home Assistant MCP Server

An MCP (Model Context Protocol) server that enables LLMs to interact with Home Assistant through its REST API.

Features

get_states - Get entity states (all or specific)
call_service - Call Home Assistant services (turn on/off lights, switches, etc.)
get_history - Get historical state data for entities
get_config - Get Home Assistant configuration
get_services - List available services
render_template - Render Jinja2 templates
get_logbook - Get logbook entries
fire_event - Fire custom events

Setup

1. Generate a Long-Lived Access Token

Log in to your Home Assistant instance
Go to your Profile (click on your name in the sidebar)
Scroll down to "Long-Lived Access Tokens"
Click "Create Token"
Give it a name (e.g., "MCP Server")
Copy the token immediately (it won't be shown again!)

2. Configure Environment

cp .env.example .env

Edit .env with your Home Assistant URL and token:

HA_URL=http://your-home-assistant-ip:8123
HA_TOKEN=your_long_lived_access_token

3. Install and Build

npm install
npm run build

Usage

With Claude Desktop

Add to your Claude Desktop configuration (~/.config/Claude/claude_desktop_config.json on Linux):

{
  "mcpServers": {
    "home-assistant": {
      "command": "node",
      "args": ["/path/to/home-assistant-mcp/dist/index.js"],
      "env": {
        "HA_URL": "http://your-home-assistant-ip:8123",
        "HA_TOKEN": "your_long_lived_access_token"
      }
    }
  }
}

With Other MCP Clients

Run the server:

npm start

The server communicates via stdio using the MCP protocol.

Example Commands

Once connected, you can ask the LLM things like:

"What's the current temperature in the living room?"
"Turn on the kitchen lights"
"Show me what happened in the last hour"
"What's the status of all my lights?"
"Set the thermostat to 22 degrees"

Development

Watch mode for TypeScript:

npm run dev

License

MIT

2.0 KiB Raw Permalink Blame History