ha-mcp-debug

Inspect Home Assistant entity states and access log files for error tracing.

Updated Feb 20, 2026

Search Tags:#automation #debugging #troubleshooting #logs #entities #home assistant

Ready to run

npx skills add https://github.com/jackmcintyre/localshift --skill ha-mcp-debug

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ha-mcp-debug
Source: https://github.com/jackmcintyre/localshift/tree/main/.opencode/skills/ha-mcp-debug
Command: npx skills add https://github.com/jackmcintyre/localshift --skill ha-mcp-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users diagnose and resolve issues within their Home Assistant (HA) environment by providing tools to inspect system states, automation traces, and log files.

Core Features & Use Cases

Real-time State Inspection: Check the current status of entities, automations, and integrations.
Log Analysis: Access and filter HA log files for error tracing and detailed debugging.
Use Case: When a Home Assistant automation is not behaving as expected, use this Skill to check the automation's traces and then examine the system logs for any related errors.

Quick Start

Use the ha-mcp-debug skill to check the state of the sensor.battery_percent entity.

Frequently Asked Questions about ha-mcp-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I debug Home Assistant automation failures using system logs?▼

Debug Home Assistant automation failures by inspecting real-time entity states and directly accessing log files to trace errors. Check automation traces and filter system logs to identify why an automation is not behaving as expected.

What is the best way to check Home Assistant entity availability and integration errors?▼

Check Home Assistant entity availability and integration errors by querying real-time system states through MCP tools. Inspect current entity statuses and review integration logs to diagnose unavailable devices or configuration issues.

Do I need MCP tools to troubleshoot Home Assistant integrations?▼

Yes, MCP tools are required to troubleshoot Home Assistant integrations. They provide the interface to access internal APIs, inspect real-time states, and retrieve the log files needed to diagnose integration errors.

Why is my Home Assistant automation not triggering and how do I diagnose it?▼

Diagnose untriggered Home Assistant automations by inspecting automation traces and checking entity states via MCP tools. Review the log files to find specific error messages or state mismatches that prevented execution.

Can I access Home Assistant log files directly to trace errors?▼

Yes, you can trace Home Assistant issues by accessing log files directly through this Skill. It provides file system access to Home Assistant logs, allowing you to filter and analyze error messages for detailed troubleshooting.