mcp-hass

SKILL.md

Control and query Home Assistant smart home devices via MCP protocol.

Supports device control commands including turn on/off, light brightness adjustment, and fan speed control with area and domain filtering

Query live device states and context across your entire Home Assistant instance

Requires MCP server integration enabled in Home Assistant with HASS_BASE_URL and HASS_ACCESS_TOKEN environment variables configured

Commands target devices by name, area, or domain for flexible multi-device operations

Home Assistant

Control Home Assistant smart home and query states using MCP protocol.

Prerequisites

Enable MCP server in Home Assistant:

Browse to your Home Assistant instance.

Go to Settings > Devices & services.

In the bottom right corner, select the + Add Integration button.

From the list, select Model Context Protocol.

Follow the instructions on screen to complete the setup.

Config

When prompted that the MCP server does not exist, remind the user to configure the HASS_BASE_URL and HASS_ACCESS_TOKEN environment variables by executing the following command to add the configuration:

npx -y mcporter config add home-assistant \
  --transport http \
  --url "${HASS_BASE_URL:-http://homeassistant.local:8123}/api/mcp" \
  --header "Authorization=Bearer \${HASS_ACCESS_TOKEN}"