mcp-hass

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

INSTALLATION
npx skills add https://github.com/aahl/skills --skill mcp-hass
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

Usage

# Get states

npx -y mcporter call home-assistant.GetLiveContext

# Turn on the device

npx -y mcporter call home-assistant.HassTurnOn(name: "Bedroom Light")

npx -y mcporter call home-assistant.HassTurnOn(name: "Light", area: "Bedroom")

# Turn off the device

npx -y mcporter call home-assistant.HassTurnOff(name: "Bedroom Light")

npx -y mcporter call home-assistant.HassTurnOff(area: "Bedroom", domain: ["light"])

# Control light

# brightness: The percentage of the light, where 0 is off and 100 is fully lit.

# color: Name of color

npx -y mcporter call home-assistant.HassLightSet(name: "Bedroom Light", brightness: 50)

# Control fan

# percentage: The percentage of the fan, where 0 is off and 100 is full speed.

npx -y mcporter call home-assistant.HassFanSetSpeed(name: "Fan", area: "Bedroom", percentage: 80)

Execute the following command to learn about specific usage methods:

  • npx -y mcporter list home-assistant --schema --all-parameters

About mcporter

  • To improve compatibility, use npx -y mcporter instead of mcporter when executing commands.
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card