Home Assistant MCP Server

Name: Home Assistant MCP Server
Author: hekmon8

@hekmon8

关于 Home Assistant MCP Server

A Model Context Protocol (MCP) server for interacting with Home Assistant. This server provides tools to control and monitor your Home Assistant devices through MCP-enabled applications.

基本信息

分类

AI 与智能体

许可证

MIT

运行时

node

传输方式

stdio

发布者

hekmon8

配置

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

{
  "mcpServers": {
    "Homeassistant-server-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@hekmon8/Homeassistant-server-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Home Assistant MCP Server?

This is a Model Context Protocol (MCP) server for interacting with Home Assistant. It provides tools to control and monitor Home Assistant devices through MCP-enabled applications, such as Claude Desktop. It is designed for Home Assistant users who want to integrate AI assistants with their smart home setup.

How to use Home Assistant MCP Server?

Install automatically via Smithery (npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude) or manually by cloning the repo, running npm install and npm run build, then configuring the MCP settings file with your Home Assistant URL (HA_URL) and a long-lived access token (HA_TOKEN). The server exposes four tools: get_state, toggle_entity, trigger_automation, and list_entities.

Key features of Home Assistant MCP Server

Get device states from Home Assistant
Control device states (turn on/off)
Trigger automations by automation ID
List available entities, optionally filtered by domain

Use cases of Home Assistant MCP Server

Ask an AI assistant to turn lights on/off
Query the current state of any Home Assistant entity
Trigger a morning routine automation from a chat interface
List all lights or switches in the system to discover entities
Monitor and control smart home devices without opening the Home Assistant UI

FAQ from Home Assistant MCP Server

What are the runtime dependencies?

Node.js and npm are required to build and run the server. A running Home Assistant instance with a long-lived access token is also needed.

How do I securely provide my Home Assistant credentials?

Set the HA_URL and HA_TOKEN environment variables in your MCP settings file. Always use HTTPS for your Home Assistant instance, keep access tokens secret, and never commit them to version control.

Where does my data live?

All device data stays on your local Home Assistant instance. The MCP server only reads from and writes to your instance; no data is sent to external services.

What transport protocol does the server use?

The server uses the standard Model Context Protocol (MCP) for communication with MCP-enabled clients.

How can I contribute or get support?

Fork the repository and submit pull requests. For issues, check existing repository issues or create a new one with context. Additional support resources are available at www.aimcp.info.