MCP.so
Sign In

Home Assistant MCP Server

@oleander

Repository

About Home Assistant MCP Server

home-assistant-mcp-server

Basic information

Category

AI & Agents

License

MIT

Runtime

node

Transports

stdio

Publisher

oleander

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

Comments

More AI & Agents MCP servers

Open Multi-Agent Canvas

CopilotKit

The open-source multi-agent chat interface that lets you manage multiple agents in one dynamic conversation and add MCP servers for deep research

507

21st.dev Magic AI Agent

21st-dev

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic

5.3K

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622

Perplexity MCP Server

DaInfernalCoder

A Model Context Protocol (MCP) server for research and documentation assistance using Perplexity AI. Won 1st @ Cline Hackathon

295

MCP Client for Ollama (ollmcp)

jonigl

Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre

768