MCP.so
登录

Home Assistant MCP Server

@oleander

关于 Home Assistant MCP Server

home-assistant-mcp-server

基本信息

分类

AI 与智能体

许可证

MIT

运行时

node

传输方式

stdio

发布者

oleander

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

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

概览

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

评论

AI 与智能体 分类下的更多 MCP 服务器