Skip to content

home-assistant-agent

scion-sdk ecosystem — control lights, switches, media players, calendars, and query historical state across the operator's smart home.

Official documentation

This site is the canonical reference for home-assistant-agent, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

home-assistant-agent wraps the Home Assistant REST and WebSocket API surface with

  • HomeAssistantApi — a unified REST + WebSocket client over the Home Assistant API (configuration, states, services, events, history, logbook, calendars, and system health).
  • Action-routed MCP tools across eleven domains — Config, States, Services, Events, History, Logbook, Calendar, Panels, Voice, Entities, and System — each toggled independently by environment flag. surface into a Pydantic-AI graph agent with an embedded web UI.

Every tool registration is governed by an environment flag, so the server exposes only the capabilities the operator enable and remains inactive when credentials are absent.

Explore the documentation

  • :material-rocket-start: Installation — pip, source, extras, and the prebuilt Docker image.
  • Usage — the MCP tools, the HomeAssistantApi client, and the CLI.
  • Backing Platform — deploy Home Assistant with Docker.
  • Overview — architecture, tool surface, and ecosystem role.
  • Concepts — the CONCEPT:HASS-* registry.

Quick start

pip install "home-assistant-agent"
home-assistant-mcp                 # stdio MCP server (default transport)

Connect it to a Home Assistant instance:

export HOME_ASSISTANT_URL=http://your-home-assistant:8123
export HOME_ASSISTANT_TOKEN=your_long_lived_access_token
home-assistant-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the proxy, DNS).