hass-mcp-server

Overview

This MCP server enables AI assistants like Claude to interact with Home Assistant via HTTP transport, offering both OAuth and Long-Lived Token authentication. It provides comprehensive access to Home Assistant features including entity management, automation control, configuration file management, dashboard operations, and system administration. The server is designed specifically to support web-based AI clients that require OAuth 2.0 authentication, addressing a need not met by the official SSE-only integration.

Try asking AI

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

• get_state

  Get the current state of any entity

  Try:What's the current temperature of the living room?Try:Show me the status of all lights
• list_entities

  List all entities with optional domain filter

  Try:List all sensors in the houseTry:Show me all lights in the kitchen
• call_service

  Call any Home Assistant service

  Try:Turn on the living room lightTry:Set thermostat to 72 degrees
• list_automations

  List all automations with full configuration

  Try:Show me all my automationsTry:List all automations that trigger at sunset
• get_automation_config

  Get full configuration of a single automation

  Try:Show me the configuration for morning routine automationTry:What does the away mode automation do?
• create_automation

  Create a new automation

  Try:Create an automation to turn on lights at sunsetTry:Make an automation that turns off all lights when I leave
• list_dashboards

  List all Lovelace dashboards with metadata

  Try:Show me all my dashboardsTry:List all dashboards in the house
• get_dashboard_config

  Get full dashboard configuration

  Try:Show me the configuration of the main dashboardTry:What's on my energy dashboard?
• list_config_files

  List all YAML files in the config directory

  Try:Show me all configuration filesTry:List all YAML files in the config folder
• get_system_status

  Get system overview including version, domain counts, and entity totals

  Try:What's the current status of Home Assistant?Try:Show me system statistics
• list_devices

  List devices, optionally filtered by area

  Try:Show me all devices in the living roomTry:List all smart home devices
• list_services

  List available services, optionally filtered by domain

  Try:Show me all available servicesTry:List all services for the light domain

Comparable tools

Installation

{
  "mcpServers": {
    "home-assistant": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-homeassistant"],
      "env": {
        "HOME_ASSISTANT_URL": "https://your-home-assistant.com",
        "HOME_ASSISTANT_TOKEN": "your-long-lived-token"
      }
    }
  }
}

FAQ

How do I list all automations, scenes, or scripts?

Use the dedicated list tools: `list_automations()`, `list_scenes()`, or `list_scripts()` to get full configurations.

What's the difference between OAuth and Long-Lived Token authentication?

OAuth is for browser-based clients like Claude and requires hass-oidc-server integration. Long-Lived Tokens are for local clients and can be used without extra dependencies.

Compare hass-mcp-server with