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

Magic Hour

Magic Hour MCP lets AI agents create and edit images, videos, and audio using Magic Hour’s hosted generation tools.

bsv.cx

Andy Rowe

Timestamp and verify evidence on-chain. Let your agent prove what it saw and when. bsv.cx gives an AI agent verifiable memory. Timestamp a hash of any output, archive a web page as it looked, or fetch a URL with a recei

Agentic Atlas

Avery Jones

Consult field-tested agent-system design patterns through 8 hosted, read-only tools for orientation, deep reading, relationships, provenance, glossary terms, and publication decisions.

Nero AI Image Processing

nero-com

We provide AI-powered tools for image enhancement, upscaling, background removal, photo restoration, colorization, denoising, and compression. All features are available through our API documentation.

🛡️ A.I.G（AI-Infra-Guard）

Tencent

A full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.

4.1K