Home Assistant MCP Server

A Model Context Protocol (MCP) server that provides access to Home Assistant entities and services.

Features

• List Entities: Browse all your Home Assistant devices (lights, switches, sensors, etc.)

• Get Entity State: Check the current state and attributes of any entity

• Call Services: Control devices (turn lights on/off, adjust climate, etc.)

• List Services: Discover available Home Assistant services

Installation

npm install
npm run build

Configuration

Set the following environment variables:

• HASS_HOST: Your Home Assistant URL (e.g., https://your-instance.ui.nabu.casa)

• HASS_TOKEN: Your Home Assistant long-lived access token

Usage with VS Code

Add to your VS Code settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "homeassistant": {
      "command": "node",
      "args": ["C:/Repos/HomeAssistant-mcp/dist/index.js"],
      "env": {
        "HASS_HOST": "https://your-instance.ui.nabu.casa",
        "HASS_TOKEN": "your-long-lived-token"
      }
    }
  }
}

Available Tools

list_entities

List all Home Assistant entities, optionally filtered by domain.

Parameters:

• domain (optional): Filter by domain (e.g., "light", "switch", "sensor")

get_entity_state

Get the current state and attributes of a specific entity.

Parameters:

• entity_id (required): The entity ID (e.g., "light.living_room")

call_service

Call a Home Assistant service to control devices.

Parameters:

• domain (required): Service domain (e.g., "light", "switch")

• service (required): Service name (e.g., "turn_on", "turn_off")

• entity_id (optional): Target entity ID

• data (optional): Additional service data (brightness, color, etc.)

list_services

List all available Home Assistant services.

License

MIT