Home Assistant

Home Assistant

MCP server enabling Home Assistant integration with Claude and other LLMs.

235
Stars
35
Forks
2
Releases

Overview

Hass-MCP is a Model Context Protocol (MCP) server for Home Assistant integration with Claude and other LLMs. It enables AI assistants to interact directly with your Home Assistant instance, allowing them to query device and sensor states, control lights and other entities, obtain summaries of your smart home, troubleshoot automations and entities, search for specific entities, and engage in guided conversations for common tasks. The server exposes a suite of MCP tools (e.g., get_version, get_entity, entity_action, list_entities, search_entities_tool, domain_summary_tool, list_automations, call_service_tool, restart_ha, get_history, get_error_log) to perform common Home Assistant operations with lean, token-efficient responses. Prerequisites include a Home Assistant instance with a Long-Lived Access Token, and a Docker-ready user experience (Docker recommended) or runtime options like uv/uvx. Installation examples show pulling the Docker image (docker pull voska/hass-mcp:latest) and configuring Claude Desktop or Cursor for easy access. The README also provides usage prompts and examples to guide setups and workflows.

Details

Owner
voska
Language
Python
License
MIT License
Updated
2025-12-07

Features

Entity Management

Get states, control devices, and search for entities

Domain Summaries

Get high-level information about entity types

Automation Support

List and control automations

Guided Conversations

Use prompts for common tasks like creating automations

Smart Search

Find entities by name, type, or state

Token Efficiency

Lean JSON responses to minimize token usage

Tags

Home AssistantMCPClaudeLLMsAutomationEntity managementDomain summariesGuided conversationsSmart searchToken efficiencyDockeruvuvx