MCP.so
登录

home-assistant-mcp MCP Server

@miguelg719

基本信息

分类

AI 与智能体

传输方式

stdio

作者

miguelg719

关于 home-assistant-mcp MCP Server

An MCP server for Home Assistant

home-assistant-mcp MCP Server 配置

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

{
  "mcpServers": {
    "home-assistant-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

home-assistant-mcp MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

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

概览

What is Home Assistant MCP Server?

This server implements the Model Context Protocol (MCP) to integrate with Home Assistant, providing smart home control capabilities for AI assistants. It is designed for developers and smart home users who want to control Home Assistant through conversational interfaces.

How to use Home Assistant MCP Server?

Configure the server by setting HOMEASSISTANT_TOKEN and HOMEASSISTANT_BASE_URL in a .env file. Install via uv or uvx and add the server to your MCP host configuration (e.g., Claude Desktop) under mcpServers as home-assistant-server. Use the provided tools and prompts for each supported domain.

Key features of Home Assistant MCP Server

  • Provides tools for lights, climate, locks, alarm panels, and humidifiers.
  • Includes prompts for each supported domain.
  • Requires only a Home Assistant long-lived access token and base URL.
  • Supports setup with Claude Desktop and other MCP hosts.
  • Published as a Python package on PyPI.

Use cases of Home Assistant MCP Server

  • Turn lights on/off and adjust brightness via an AI assistant.
  • Set temperature and HVAC mode using natural language.
  • Lock or unlock doors through a conversational interface.
  • Arm or disarm a home security system with voice commands.
  • Control humidifier humidity levels remotely.

常见问题

1

What prerequisites are needed?

A running Home Assistant instance, a long-lived access token from your Home Assistant profile, and the base URL of your Home Assistant (e.g., `http://homeassistant.local:8123`).

2

How is authentication handled?

The server uses a long-lived access token set in the `HOMEASSISTANT_TOKEN` environment variable. The token must be generated from the Home Assistant instance after onboarding.

3

What transport does the server use?

The MCP server communicates over stdio, which is standard for MCP servers. Debugging can be done using the MCP Inspector.

4

Does the server support all Home Assistant entities?

No, currently only lights, climate, locks, alarm control panels, and humidifiers are supported. Other domains are not yet implemented.

5

How can I install the server?

The server can be run via `uv` for development or via `uvx` for the published version. Configuration examples for Claude Desktop are provided in the README.

评论

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