allenporter/mcp-server-home-assistant

Overview

This is a Model Context Protocol (MCP) server for Home Assistant. It implements the MCP standard to expose Home Assistant entities and services, allowing AI agents to query and control home automation devices. Built in Python, it acts as a bridge between MCP-compatible clients and the Home Assistant API.

Best for

Best for
Developers building AI agents or assistants that need to interact with Home Assistant devices and automations.

Use cases

• Enabling AI assistants to turn lights on/off or adjust thermostats.
• Querying sensor states (temperature, motion, etc.) from Home Assistant.
• Automating home routines triggered by AI-driven decisions.

How to use

Tools exposed

• uv

Tested with

Claude Desktop

Example client config

{\n    "mcpServers": {\n        "Home-assistant": {\n            "command": "uv",\n            "args": [\n                "--directory",\n                "/Users/allen/Development/mcp-server-home-assistant",\n                "run",\n                "mcp-server-home-assistant",\n                "-v",\n                "-v"\n            ],\n            "env": {\n                "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket",\n                "HOME_ASSISTANT_API_TOKEN": "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9....."\n            }\n        }\n    }\n}

Notes

This is a Model Context Protocol (MCP) server for Home Assistant. It implements the MCP standard to expose Home Assistant entities and services, allowing AI agents to query and control home automation devices. Built in Python, it acts as a bridge between MCP-compatible clients and the Home Assistant API.

67 stars on GitHub. Last updated 2025-03-02. Licensed Apache-2.0.

Use cases

• Enabling AI assistants to turn lights on/off or adjust thermostats.
• Querying sensor states (temperature, motion, etc.) from Home Assistant.
• Automating home routines triggered by AI-driven decisions.

Pros

• Open source and written in Python, making it easy to extend or customize.
• Adheres to the Model Context Protocol, ensuring compatibility with any MCP client.
• Lightweight server that directly integrates with a local Home Assistant instance.

Cons

• Small community size (67 stars) may mean limited support and fewer contributions.
• Requires a running Home Assistant instance and proper authentication setup.
• Dependent on the stability of the MCP specification and Home Assistant API changes.

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.