Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    ha tool

    1

    Control, query, and manage Home Assistant entities and services via a structured CLI interface.

    Free

    Security scanned
    ha tool

    ha tool

    Example session with this skill installed

    Find all temperature sensors in the Kitchen and show their current states.

    • Read your context and instructions
    • Compiled the ha tool

    I have queried the Home Assistant registry for temperature sensors located in the Kitchen.

    Kitchen Temperature Sensors

    Entity IDFriendly NameStateLast Changed
    sensor.kitchen_multi_tempKitchen Multi-Sensor Temperature21.42023-10-27T14:30:05Z
    sensor.fridge_thermometerRefrigerator Temperature3.82023-10-27T14:45:12Z
    sensor.oven_probeOven Internal Probeunavailable2023-10-27T08:00:00Z

    Next steps

    • Use ha-tool -o json history sensor.kitchen_multi_temp --since 1h to see recent trends.
    • Check the health command if the oven probe remains unavailable.
    • Call ha-tool -o json stale-report --area Kitchen to identify other offline devices.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Managing a Home Assistant instance via a terminal or through agentic workflows often involves clunky API calls or navigating a complex UI. This skill provides a direct interface to ha-tool, enabling programmatic discovery, inspection, and control of your smart home environment.

    What it does

    • Entity discovery Lists areas, domains, integrations, and services with JSON output.
    • State management Inspects current entity states or queries historical data and logbooks.
    • Device control Calls services to toggle lights, set thermostats, or trigger automations via structured data.
    • System maintenance Validates configuration files, reloads integrations, and monitors system health or error logs.
    • Registry editing Renames entities, updates metadata, or wraps switches as lights/fans without manual YAML edits.
    • Live monitoring Streams real-time events and state changes using a non-blocking NDJSON format.

    How it works

    1. Discovery Use search or inspect to identify target entities and their supported domains.
    2. Query Retrieve state history or render Jinja2 templates to verify logic before deployment.
    3. Execution Call specific services using the call command with JSON-formatted data and targets.
    4. Validation Run check-config or stale-report to ensure the instance is running correctly.

    Frameworks & tools

    Requires ha-tool (Python-based CLI), HASS_SERVER and HASS_TOKEN environment variables, and optionally uv for execution.

    Why this beats prompting it yourself

    Writing raw cURL commands for Home Assistant is error-prone due to complex JSON payloads and authentication headers. This skill leverages a specialized CLI that handles the API heavy lifting, providing structured JSON that an agent can parse reliably.

    Use cases

    • Automate the cleanup of stale or unavailable entities across specific areas.
    • Batch rename entity IDs after a hardware migration or integration rebuild.
    • Build custom monitoring dashboards by streaming live events via watch.
    • Debug automation logic by rendering Jinja2 templates against live sensor data.

    Known limitations

    The stale-report flag is advisory and may return false positives for change-only sensors. Permanent entity removal is limited to helpers and manual entities.

    Stale-report flags are advisory. Registry removals for integration-managed entities require device or config-entry targeting. Environment variables must be pre-configured.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 21 days ago

    • Free with an Agensi account

    Requires

    uv (Python tool runner)

    Permissions

    Terminal / Shell
    Listed21 days ago

    What's inside

    Frequently Asked Questions

    This skill provides a structured CLI wrapper for the Home Assistant API, replacing complex cURL commands and manual UI navigation with clear, agent-friendly commands for entity discovery, state management, and service execution.

    You will need a running Home Assistant instance, a Long-Lived Access Token, and the `ha-tool` Python package installed. The skill connects via the `HASS_SERVER` and `HASS_TOKEN` environment variables.

    Yes, this skill is designed to be framework-agnostic and works with any agent capable of executing shell commands or CLI tools, including those built with LangChain, AutoGPT, or custom Python scripts.

    The skill can control any entity exposed to Home Assistant, including lights, climate controls, and media players, and can trigger any registered service using structured JSON data.

    The `watch` command streams real-time state changes and events in NDJSON format, allowing your agent to monitor your home environment continuously without constant polling.

    While the skill allows for powerful registry edits and service calls, it respects Home Assistant's internal permissions; for example, permanent entity removal is restricted to helpers and manually created entities to prevent system instability.

    New in Workflow Automation