π¬ 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
- Enable "Enable beta features (master)" in HA-MCP Server Settings.
- Enable "Enable dashboard screenshot mode (beta)" sub-toggle.
- Install the Puppet add-on (same repository), set its
access_token, confirm it's running.
- Set "Dashboard screenshot engine URL" to
http://<puppet-slug>:10000.
- Restart the ha-mcp add-on (confirmed full stop/start cycle, not just a state check).
- 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)
π¬ What Happened?
π Bug Description
The "Enable dashboard screenshot mode (beta)" setting has no effect β
ha_config_get_dashboard/ha_config_set_dashboardwithinclude_screenshot/return_screenshotalways return "Screenshot requested but dashboard screenshot mode is disabled," even with every documented prerequisite satisfied.π Steps to Reproduce
access_token, confirm it's running.http://<puppet-slug>:10000.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