Get HACS Info
ha_get_hacs_infoSearch the Home Assistant Community Store for custom components or retrieve detailed repository information including README and GitHub statistics.
Instructions
Get HACS (Home Assistant Community Store) data — search the store or fetch repository details.
Use action="search" to search/browse/list store repositories, or
action="info" for one repository's full details (README, versions, GitHub
stats). This tool is read-only; to install or add repositories use
ha_manage_hacs, and for non-HACS entities/config use the domain-specific tools.
DASHBOARD TIP: action="search", installed_only=True, category="lovelace"
discovers installed custom cards to wire into ha_config_set_dashboard().
Examples:
Search the store: ha_get_hacs_info(action="search", query="mushroom", category="lovelace")
List installed: ha_get_hacs_info(action="search", installed_only=True)
Repository details: ha_get_hacs_info(action="info", repository_id="441028036")
Caveats: info fetches full repository detail from GitHub, so it can hit GitHub
rate limits / needs HACS's configured GitHub token; search reads HACS's locally
cached repository index. repository_id accepts a numeric HACS ID or an
owner/repo path.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search keyword (action='search') | |
| action | Yes | 'search' the store, or 'info' for one repository | |
| offset | No | Results to skip for pagination (action='search', default: 0) | |
| category | No | Filter by category (action='search') | |
| max_results | No | Maximum number of results (action='search', default: 10, max: 100) | |
| repository_id | No | Numeric HACS ID or 'owner/repo' path (action='info') | |
| installed_only | No | Only return installed repositories (action='search', default: False) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||