koneisto avatar

Homeassistant Light Mcp

koneisto/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 tools

Public 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*secret

Home Assistant long-lived access token

Readme

Home Assistant Light MCP

npm version CI License: MIT

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

View the full README on GitHub

Details

Repository
github.com/koneisto/homeassistant-light-mcp
Category
Design & Creative
Package
ha-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Design & Creative MCP servers

View all
1laaielichter avatarThreesmithlaaielichter/threesmiththree.js for coding agents: version-pinned API and review, assets, headless runs, perf, 3D models.0stars
2gueguesser-chatgptap-68537aa2 avatarMy MCP Serverlive.alpic.gueguesser-chatgptap-68537aa2/gueguesser-chatgptappGeography Guesser game0stars
3lyellr88 avatarBuddy Mcplyellr88/buddy-mcpClaude Code creature collection game. Hatch buddies, pet to boost roll luck, complete the BuddyDex.0stars
4o-shabashov avatarDOS2 Game Mastero-shabashov/dos2-gm-mcpDivinity: Original Sin 2 Game Master mode: edit campaign files, drive the live game via a bridge mod0stars
5promptibus avatarPromptibus MCPpromptibus/mcpModel intelligence for AI agents — syntax, parameters, pricing, and routing for 67+ generative AI models (Midjourney, Flux, Suno, Runway, DALL-E, Stable Diffusi0stars
6rayyanzahid avatarSkewrayyanzahid/skewAuthored design service: one-of-one landing pages, pitch decks, and research-grounded briefs.0stars