mcp-hass

Installation
Summary

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
SKILL.md

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}"
Related skills
Installs
1.4K
Repository
aahl/skills
GitHub Stars
125
First Seen
Feb 10, 2026