HomeAssistant Light MCP
Safely control Home Assistant lights and scenes from your agent without granting broader smart-home device access.
Overview
Home Assistant Light MCP is an MCP server for the Build phase that lets agents control only Home Assistant lights and scenes via a stdio npm server.
What is this MCP server?
- Controls Home Assistant lights and scenes only—explicit safety boundary
- Stdio MCP via npm package ha-mcp-server v0.6.1
- Requires HA_URL and HA_TOKEN (long-lived access token)
- Self-hosted against your Home Assistant instance (e.g. http://192.168.1.100:8123)
- npm package ha-mcp-server version 0.6.1
- 2 required env vars: HA_URL, HA_TOKEN
- Scope: lights and scenes only by design
What problem does it solve?
You want voice-or-agent-driven lighting automations but fear giving an AI full Home Assistant entity control.
Who is it for?
Indie hackers with a Home Assistant setup who want Claude or Cursor to tweak lighting and scenes for demos, focus modes, or dev ergonomics.
Skip if: Whole-home automation needs (climate, locks, scripts broadly) or teams without a self-hosted Home Assistant instance.
What do I get? / Deliverables
You install ha-mcp-server, set HA_URL and HA_TOKEN, and your agent can adjust lights and scenes within the intentional safety limit.
- Agent control of Home Assistant light entities
- Scene activation through MCP tools
- Deliberately limited HA surface (no arbitrary entity writes)
Recommended MCP Servers
Journey fit
Home automation hooks are added while building personal tooling or demo integrations that talk to your HA instance. Lights-and-scenes-only MCP is an integration surface to Home Assistant APIs, not production error monitoring or cloud deploy.
How it compares
Restricted Home Assistant lights MCP, not a general smart-home marketplace or cloud IoT platform integration.
Common Questions / FAQ
Who is Home Assistant Light MCP for?
Home Assistant users who want AI agents to control lighting and scenes only, prioritizing safety over full-device access.
When should I use Home Assistant Light MCP?
Use it when integrating agent workflows with your HA instance for lighting scenes, office ambiance, or limited home automation experiments.
How do I add Home Assistant Light MCP to my agent?
Install npm package ha-mcp-server (v0.6.1), configure stdio MCP with environment variables HA_URL and HA_TOKEN from a Home Assistant long-lived token.