MCP.so
Sign In

Home Assistant MCP Server

@oleander

Repository

About Home Assistant MCP Server

home-assistant-mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "home-assistant-mcp-server": {
      "command": "bun",
      "args": [
        "run",
        "build"
      ]
    }
  }
}

Tools

10

Query entity states

List lights

Control a light

Call Home Assistant services

Retrieve historical entity data

List available services

Get Home Assistant configuration

List available domains

Get Home Assistant error log

Get all devices in Home Assistant

Overview

What is Home Assistant MCP Server?

Home Assistant MCP Server is a Model Context Protocol (MCP) server for integrating with Home Assistant, enabling LLMs to control and query your smart home via natural language. It works with any MCP‑compatible client, such as Claude Desktop.

How to use Home Assistant MCP Server?

Install globally with bun install -g home-assistant-mcp-server or build from source. Configure a .env file with HASS_URL and HASS_TOKEN (or HASS_MOCK=true for demo). Run as a standalone server with home-assistant-mcp-server (default HTTP/SSE) or add the --stdio flag for stdio transport. For Claude Desktop, edit claude_desktop_config.json to include the server command and environment variables.

Key features of Home Assistant MCP Server

  • Query and control Home Assistant entities via natural language
  • Works with any MCP‑compatible client
  • Provides tools for state management, service calls, and history
  • Secure authentication using long‑lived access tokens
  • Multiple transport options: stdio and SSE/HTTP
  • Demo mode with mock data for testing without Home Assistant

Use cases of Home Assistant MCP Server

  • Control lights and smart devices via natural language from an LLM
  • Query entity states and history for automation and insights
  • Test integrations using demo mode when no Home Assistant is available
  • Run locally via stdio or remotely over HTTP/SSE
  • Integrate with Claude Desktop for conversational smart home control

FAQ from Home Assistant MCP Server

How do I enable demo mode for testing without Home Assistant?

Set HASS_MOCK=true in the .env file or pass the --mock flag when starting the server.

What are the authentication requirements?

You need a Home Assistant long‑lived access token. Generate one from your Home Assistant profile and set it as the HASS_TOKEN environment variable.

How do I run

Frequently asked questions

How do I enable demo mode for testing without Home Assistant?

Set `HASS_MOCK=true` in the `.env` file or pass the `--mock` flag when starting the server.

What are the authentication requirements?

You need a Home Assistant long‑lived access token. Generate one from your Home Assistant profile and set it as the `HASS_TOKEN` environment variable.

Comments

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

oleander

More AI & Agents MCP servers

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416

MCP Claude Code

SDGLBL

MCP implementation of Claude Code capabilities and more

302

Perplexity Ask MCP Server

ppl-ai

The official MCP server implementation for the Perplexity API Platform

2.4K

1MCP - One MCP Server for All

1mcp-app

A unified Model Context Protocol server implementation that aggregates multiple MCP servers into one.

468

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD