Happy slice of mcp pizzaMCP.pizza

homeassistant-mcp

MCP.Pizza Chef: tevonsb

Home Assistant already knows about your lights, thermostat, blinds, switches, media players, fans, locks, vacuums, and cameras. This hands that control to a chat assistant, along with the ability to read device states and build automations. You need Home Assistant running at home and a long-lived access token from your profile page. Setting it up means cloning the project and building it with Node before pointing Claude Desktop at the result. Some pieces, including live updates, are still listed as unfinished.

Other

Use This MCP server To

Turn off every light downstairs before bed Check whether anyone left the garage door open Set the thermostat for the evening without opening an app Ask which devices are currently switched on Create an automation that runs the vacuum on weekday mornings

README

Model Context Protocol Server for Home Assistant

The server uses the MCP protocol to share access to a local Home Assistant instance with an LLM application.

A powerful bridge between your Home Assistant instance and Language Learning Models (LLMs), enabling natural language control and monitoring of your smart home devices through the Model Context Protocol (MCP). This server provides a comprehensive API for managing your entire Home Assistant ecosystem, from device control to system administration.

License Node.js Docker Compose NPM TypeScript Test Coverage

Features

  • 🎮 Device Control: Control any Home Assistant device through natural language
  • 🔄 Real-time Updates: Get instant updates through Server-Sent Events (SSE)
  • 🤖 Automation Management: Create, update, and manage automations
  • 📊 State Monitoring: Track and query device states
  • 🔐 Secure: Token-based authentication and rate limiting
  • 📱 Mobile Ready: Works with any HTTP-capable client

Real-time Updates with SSE

The server includes a powerful Server-Sent Events (SSE) system that provides real-time updates from your Home Assistant instance. This allows you to:

homeassistant-mcp FAQ

What do I need before starting?
A working Home Assistant setup, a long-lived access token from your profile page, and Node installed on the machine that runs the server.
Which app does it connect to?
Claude Desktop is the documented one, and it runs the server directly rather than through the Docker option.
Can I use this to control my lights just by asking?
Yes. Lights, heating, blinds, switches, media players, fans, locks, and vacuums are all covered.
Is it finished?
Not entirely. The author lists live updates, extra security work, and performance tuning as still in progress, and the last code change was January 2026.
Is this an official Home Assistant project?
No. It is a community project and is not affiliated with Home Assistant.
How hard is the setup?
You clone the project, build it, and edit a settings file, so expect a technical evening rather than a few clicks.
Does it work outside my home network?
Only if your Home Assistant is already reachable that way. The server connects to whatever address you give it.