hass-mcp

Overview

Hass-MCP is a comprehensive MCP server that bridges AI assistants with Home Assistant smart home systems. It provides tools for querying device states, controlling lights and switches, managing automations, and troubleshooting issues. The server implements multiple MCP endpoints including tools for entity actions, domain summaries, and automation support, along with resources for accessing detailed entity information. With optimized JSON responses for token efficiency, it's designed for seamless integration with Claude Desktop and other MCP-compatible clients.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• get_version

  Get the Home Assistant version

  Try:What's my Home Assistant version?
• get_entity

  Get the state of a specific entity with optional field filtering

  Try:What's the current state of my living room lights?Try:Get temperature from my kitchen sensor
• entity_action

  Perform actions on entities (turn on, off, toggle)

  Try:Turn off all the lights in the kitchenTry:Toggle my bedroom fan
• list_entities

  Get a list of entities with optional domain filtering and search

  Try:List all my sensors that contain temperature dataTry:Show me all light entities
• search_entities_tool

  Search for entities matching a query

  Try:Search for entities related to my living roomTry:Find all climate control devices
• domain_summary_tool

  Get a summary of a domain's entities

  Try:Give me a summary of my climate entitiesTry:Show me information about all switch entities
• list_automations

  Get a list of all automations

  Try:List all my automationsTry:Show me motion sensor automations
• call_service_tool

  Call any Home Assistant service

  Try:Restart Home AssistantTry:Reload all automations
• restart_ha

  Restart Home Assistant

  Try:Restart Home AssistantTry:Reboot my Home Assistant instance
• get_history

  Get the state history of an entity

  Try:Get history of my living room temperature sensorTry:Show me motion detection history for the past day
• get_error_log

  Get the Home Assistant error log

  Try:Show me recent Home Assistant errorsTry:Why is my automation failing?
• create_automation

  Guide for creating Home Assistant automations based on trigger type

  Try:Create an automation that turns on lights at sunsetTry:Help me make a motion sensor automation

Comparable tools

Installation

docker pull voska/hass-mcp:latest

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "http://homeassistant.local:8123",
        "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN"
      }
    }
  }
}

FAQ

What permissions does Hass-MCP require?

Hass-MCP needs a Home Assistant long-lived access token with sufficient permissions to control devices and access entity data.

Can I use Hass-MCP with other AI assistants besides Claude?

Yes, Hass-MCP is compatible with any MCP client that implements the Model Context Protocol, including Cursor and Claude Code CLI.

On Hacker News

Recent discussion from the developer community.

• Hass-mcp: Home Assistant MCP server to integrate with Claude▲ 3
  Story by voska · 2025-03-17
• Home Assistant MCP Server▲ 1
  Story by voska · 2025-08-21

Compare hass-mcp with