Skip to content

Issue with dashboard screenshot toolΒ #2247

Description

@Airitix

πŸ’¬ What Happened?

πŸ“‹ Bug Description

The "Enable dashboard screenshot mode (beta)" setting has no effect β€” ha_config_get_dashboard/ha_config_set_dashboard with include_screenshot/return_screenshot always return "Screenshot requested but dashboard screenshot mode is disabled," even with every documented prerequisite satisfied.

πŸ”„ Steps to Reproduce

  1. Enable "Enable beta features (master)" in HA-MCP Server Settings.
  2. Enable "Enable dashboard screenshot mode (beta)" sub-toggle.
  3. Install the Puppet add-on (same repository), set its access_token, confirm it's running.
  4. Set "Dashboard screenshot engine URL" to http://<puppet-slug>:10000.
  5. Restart the ha-mcp add-on (confirmed full stop/start cycle, not just a state check).
  6. Call ha_config_get_dashboard(include_screenshot=True, url_path=..., view_path=...).

βœ… Expected vs ❌ Actual Behavior

Expected: A rendered screenshot of the dashboard view, or at minimum an error naming a real remaining blocker (e.g., can't reach Puppet, auth failure).

Actual: Same static message every time: "Screenshot requested but dashboard screenshot mode is disabled. Enable the 'dashboard screenshot' beta feature to use it." β€” regardless of the above steps.


πŸ’¬ Triggering Prompt & Tool Call

User prompt: "Access token added & Addon is running. Try the screenshot tool now..." (after enabling both beta toggles, installing/configuring Puppet, and setting the engine URL)

Tool call(s):

πŸ“‹ Copy-Paste from Conversation

---

## πŸ”§ Environment

- **ha-mcp Version:** 8.3.0
- **Installation Method:** addon
- **MCP Transport:** http
- **MCP Client:** unknown (not advertised)
- **AI Model:** Claude (Anthropic), Sonnet 5
- **Home Assistant Version:** 2026.8.2
- **Connection Status:** Connected
- **Entity Count:** 3477

---

## βš™οΈ ha-mcp Configuration

- **enable_beta_features:** `True`
- **enable_websocket:** `True`
- **enable_dashboard_partial_tools:** `True`
- **enable_tool_search:** `False`
- **enable_yaml_config_editing:** `False`
- **enable_filesystem_tools:** `True`
- **enable_code_mode:** `False`

**Note:** `enable_dashboard_screenshot` does not appear anywhere in this auto-collected config dump, despite the setting being toggled on in the Server Settings UI β€” every other enabled/disabled beta flag is correctly tracked here except this one.

---

## πŸš€ Startup Logs (relevant excerpt)

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingneeds-infoAwaiting clarification from reporterruntime-bugBug occurring during normal operation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions