Home Assistant

Provides tools to query and control Home Assistant devices via MCP, including getting states, toggling devices, triggering automations, and listing entities.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 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": {
    "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 can control and monitor your Home Assistant environment through a dedicated MCP Server. It exposes practical tools to read device states, toggle devices, trigger automations, and list entities, enabling you to build MCP-enabled applications that interact with Home Assistant in a consistent, scriptable way.

How to use

Use your MCP client to invoke the available tools provided by the Home Assistant MCP Server. You can read a device state, toggle a device on or off, trigger an automation, or fetch the list of entities. Each action is exposed as a distinct tool you call through the MCP interface.

How to install

Prerequisites: Node.js and npm must be installed on your machine.

Step by step commands to set up the server locally:

# 1. Clone the repository
git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

Additional sections

Configuration details and security considerations are provided to help you start safely and keep your setup secure. You will set environment variables to point to your Home Assistant instance and provide an access token with the required permissions.

Usage examples show how to call the server’s tools from your MCP client. You will interact with four tools: get_state, toggle_entity, trigger_automation, and list_entities.

Security best practices include using HTTPS for your Home Assistant instance, protecting access tokens, rotating tokens regularly, and using environment variables for sensitive information.

If you need help, you can check for issues or reach out for support resources at the MCP ecosystem’s resources page.

Available tools

get_state

Fetches the current state of a specified entity from Home Assistant.

toggle_entity

Sets the state of a specified entity to on or off.

trigger_automation

Triggers a specified automation in Home Assistant.

list_entities

Lists entities, with an optional filter by domain to narrow results.

Built by

VeilStrat

AI signals for GTM teams