Home Assistant MCP Server

Enables natural language interaction with Home Assistant entities using the Model Context Protocol.

Local serverstdio★ 5

What is the Home Assistant MCP Server?

Enables natural language interaction with Home Assistant entities using the Model Context Protocol.

What it actually does

Create a .env file in your current directory with the following variables:

  • Query and control Home Assistant entities via natural language
  • Works with any MCP-compatible client (like Claude Desktop)
  • Provides tools for state management, service calls, history, and more
  • Secure authentication using Home Assistant long-lived access tokens
  • Multiple transport options (stdio for local processes, SSE for remote clients)
  • Demo mode with mock data for testing and demonstration when Home Assistant is not available

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
statesQuery entity states
lightsList lights
lightControl a light
serviceCall Home Assistant services
historyRetrieve historical entity data
servicesList available services
configGet Home Assistant configuration
domainsList available domains
error_logGet Home Assistant error log
devicesGet all devices in Home Assistant

Configuration

VariableDescriptionRequired
HASS_URLEndpoint or connection string the server talks to.Yes
HASS_TOKENCredential the server authenticates with.Yes
HASS_MOCKConfiguration value read at startup.Optional

Example prompts to try

  • “Use Home Assistant to states.”
  • “Use Home Assistant to lights.”
  • “Use Home Assistant to light.”

Frequently asked questions

It's a Model Context Protocol (MCP) server that allows you to control and query your Home Assistant smart home using natural language through Large Language Models (LLMs).