hass-mcp
hass-mcp is an MCP server. It needs HA_TOKEN to authenticate. Its repository has 349 GitHub stars and is licensed under MIT; we last read it on 2026-10-24.
This repository provides a server implementing the Model Context Protocol (MCP) to control and query Home Assistant from Claude and other language models.
Install
Read from hass-mcp’s own README, close to verbatim -- not written by us, and not guessed.
claude mcp add hass-mcp -e HA_URL=http://homeassistant.local:8123 -e HA_TOKEN=YOUR_LONG_LIVED_TOKEN -- docker run -i --rm -e HA_URL -e HA_TOKEN voska/hass-mcp
What it reaches, and what it needs
Reaches
○ not recognised
Credential
HA_TOKEN
Maintenance
Stars
349
State
listed
Licence
MIT
From the repository
Control and query Home Assistant from Claude and other LLMs — a Model Context Protocol (MCP) server.
What hass-mcp can do
35 tools documented in its README. An AI client calls these by name.
get_version- Get the Home Assistant version
get_entity- Get the state of a specific entity with optional field filtering
entity_action- Perform actions on entities (turn on, off, toggle)
list_entities- Get a list of entities with optional domain filtering and search
search_entities_tool- Search for entities matching a query
domain_summary_tool- Get a summary of a domain's entities
list_automations- Get a list of all automations
call_service_tool- Call any Home Assistant service
restart_ha- Restart Home Assistant
get_history- Get the state history of an entity (last N hours)
get_history_range- Get state-change history for an entity over an explicit date/time range (`start_time` / `end_time`, ISO-8601)
get_statistics- Get long-term aggregated statistics (mean / min / max per bucket) for an entity over the last N hours — works for data older than the recorder's short-term retention window
get_statistics_range- Same, but for an explicit date/time range — useful for monthly / yearly trend queries
get_error_log- Get the Home Assistant error log, with optional `level` / `integration` / `search_term` / `lines` filters applied server-side so noisy logs don't blow Claude's context
get_entities_by_area- List entities in a specific area / room
list_dashboards- List dashboards (the default plus any user dashboards), each with its `url_path` and `mode` (`storage` / `yaml`)
get_dashboard_config- Get a dashboard's full config
set_dashboard_config- Replace a dashboard's full config (low-level)
add_card- Add a card to a dashboard
update_card- Update a card in a dashboard
remove_card- Remove a card from a dashboard
move_card- Move a card within a dashboard
list_view_sections- List the sections of a 'sections'-type view
add_view- Add a view to a dashboard
remove_view- Remove a view from a dashboard
update_view- Update a view in a dashboard
list_dashboard_backups- List automatic pre-save backups
restore_dashboard- Restore a dashboard from a backup
create_automation- Guide for creating Home Assistant automations based on trigger type
debug_automation- Troubleshooting help for automations that aren't working
troubleshoot_entity- Diagnose issues with entities
routine_optimizer- Analyze usage patterns and suggest optimized routines based on actual behavior
automation_health_check- Review all automations, find conflicts, redundancies, or improvement opportunities
entity_naming_consistency- Audit entity names and suggest standardization improvements
dashboard_layout_generator- Create optimized dashboards based on user preferences and usage patterns
Read from the README; names are kept only if the README contains them.
Common questions about hass-mcp
- What does hass-mcp do?
- This repository provides a server implementing the Model Context Protocol (MCP) to control and query Home Assistant from Claude and other language models.
- How do I install hass-mcp?
- Its own README gives this command: claude mcp add hass-mcp -e HA_URL=http://homeassistant.local:8123 -e HA_TOKEN=YOUR_LONG_LIVED_TOKEN -- docker run -i --rm -e HA_URL -e HA_TOKEN voska/hass-mcp. Run it where your MCP client can launch the server, and check the README for any settings it asks for.
- What does hass-mcp connect to, and what does it need?
- The credentials we found in its source are HA_TOKEN.
- Is hass-mcp official and is it maintained?
- We found nothing naming it as a vendor’s official server. Its repository has 349 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-10-19.
- What licence does hass-mcp use?
- The repository declares the MIT licence.