Home Assistant

Provides a MCP server to query, control Home Assistant devices, trigger automations, and list entities.

typescript

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-hekmon8_homeassistant-server-mcp": {
      "command": "node",
      "args": [
        "/path/to/homeassistant-mcp/homeassistant-server/build/index.js"
      ],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

You set up this MCP server to interact with your Home Assistant instance. It lets you read device states, toggle devices, trigger automations, and list entities from MCP-enabled applications, all through a lightweight, configurable bridge between your Home Assistant setup and MCP clients.

How to use

You connect to this server from an MCP client and invoke named tools to perform actions or fetch data from Home Assistant. The core capabilities you can use are getting device states, turning devices on or off, triggering automations, and listing entities. Each tool accepts specific arguments such as an entity ID or automation ID, and the client receives structured results that reflect the current state or the outcome of your action.

How to install

Prerequisites You need Node.js installed on your machine. Ensure you have npm available for installing dependencies.

Clone the project repository to your workspace.
Install dependencies.
Build the project.
Configure the MCP server in your MCP settings.

{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

Security

To securely operate this server, always use HTTPS where possible, keep access tokens confidential, rotate tokens periodically, and use environment variables to manage sensitive information.

Support

If you encounter issues or need guidance, start by checking existing issues, open a new issue with context, and visit the MCP resources for additional support.

Available tools

get_state

Fetch the current state of a specified entity in Home Assistant.

toggle_entity

Set an entity state to on or off, effectively toggling its state.

trigger_automation

Trigger a specified automation in Home Assistant.

list_entities

List entities, optionally filtering by domain (e.g., lights).

Built by

VeilStrat

AI signals for GTM teams