
Homeassistant Light Mcp
A focused Home Assistant integration that deliberately limits scope to lights only for safety reasons. It exposes eight tools including scene_show_lights for viewing RGB colors and brightness, scene_adjust_light for controlling individual lights, and full scene management (create, activate, update, delete). Also includes scene_blackout to kill all lights with optional exclusions. The key differentiator is detailed color information that the official Home Assistant MCP doesn't expose, plus built-in workarounds for IKEA Tradfri timing issues when switching between RGB and Kelvin modes. Scenes are backed up locally to ~/.config/ha-mcp-server and support both exclusive and additive modes. Connects via Home Assistant's REST API using a long-lived access token.
- tools
- 11
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Dec 8, 2025
Tools
11 toolsPublic tool metadata for what this MCP can expose to an agent.
scene_show_lightsShow all lights with state, brightness, colors, effects, color modes
Show all lights with state, brightness, colors, effects, color modes
No parameter schema in public metadata yet.
scene_adjust_lightControl a light (on/off, brightness, color, effects)
Control a light (on/off, brightness, color, effects)
No parameter schema in public metadata yet.
scene_createCreate a new scene from current light states
Create a new scene from current light states
No parameter schema in public metadata yet.
scene_listList all scenes
List all scenes
No parameter schema in public metadata yet.
scene_activateActivate a scene
Activate a scene
No parameter schema in public metadata yet.
scene_updateUpdate existing scene with current lights
Update existing scene with current lights
No parameter schema in public metadata yet.
scene_deleteDelete a scene
Delete a scene
No parameter schema in public metadata yet.
scene_blackoutTurn off all lights (supports exclusions)
Turn off all lights (supports exclusions)
No parameter schema in public metadata yet.
scene_diagnoseDiagnose lights and scenes, check connectivity
Diagnose lights and scenes, check connectivity
No parameter schema in public metadata yet.
scene_fixFix scene problems, restore from backup
Fix scene problems, restore from backup
No parameter schema in public metadata yet.
scene_configureSet Home Assistant URL and token
Set Home Assistant URL and token
No parameter schema in public metadata yet.
Sponsors
Configuration
HA_URL*Home Assistant URL (e.g., http://192.168.1.100:8123)
HA_TOKEN*secretHome Assistant long-lived access token
Readme
Home Assistant Light MCP
A Model Context Protocol (MCP) server for controlling Home Assistant lights and managing scenes. Complements the official Home Assistant MCP by providing detailed light control with colors and scene management.
Like this project? Give it a ⭐ on GitHub and help others discover it!
Design Philosophy: Lights Only
This MCP intentionally controls only lights - not switches, not other entities. This is a deliberate safety decision:
- Switches can control critical systems - HVAC, heaters, air conditioning, water pumps
- Accidental activation could be dangerous - turning on a heater while away, disabling AC in summer
- Lights are safe - worst case is lights turn on/off unexpectedly
Details
- Repository
- github.com/koneisto/homeassistant-light-mcp
- Category
- Design & Creative
- Package
ha-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active