Back to Apps

Hass-MCP
by voska
Control your Home Assistant smart home using AI with professional-grade MCP tools.
4 stars
Updated 4 months ago
Works in:CursorChatGPT
Exposes:Tools
What it does\nConnects AI assistants to a Home Assistant instance, allowing the AI to query, manage, and control smart home entities directly via the Model Context Protocol.\n\n## Tools\n- get_version: Retrieves the Home Assistant version.\n- get_entity: Gets the state of a specific entity.\n- entity_action: Controls entities (on, off, toggle).\n- list_entities: Lists entities with domain/search filters.\n- search_entities: Searches for entities by name, ID, or attributes.\n- domain_summary: Provides state distribution for a domain.\n- system_overview: Full overview of the HA system.\n- list_automations: Lists all automations and their states.\n- call_service: Low-level API call to any HA service.\n- get_history: Retrieves state change history for an entity.\n- get_error_log: Fetches the Home Assistant error log.\n- restart_ha: Restarts the Home Assistant instance.\n\n## Installation\nAdd the following to your claude_desktop_config.json:\n\njson\n{\n \"mcpServers\": {\n \"home-assistant\": {\n \"command\": \"/path/to/hass-mcp\",\n \"args\": [\"--config\", \"/path/to/config-stdio.yaml\"],\n \"env\": {\n \"HA_URL\": \"http://homeassistant.local:8123\",\n \"HA_TOKEN\": \"your-token-here\"\n }\n }\n }\n}\n\n\n## Supported hosts\nClaude, Cursor, OpenAI
Quick install
docker pull ghcr.io/achetronic/hass-mcp:latestInformation
- Pricing
- free
- Published
- 4/16/2026
- Updated
- 4 months ago
- stars
- 4
Categories
Choose your AI client and follow the steps below.
Cursor
Add to .cursor/mcp.json using the same config as Claude Desktop.Claude Desktop
{
"mcpServers": {
"home-assistant": {
"command": "/path/to/hass-mcp",
"args": ["--config", "/path/to/config-stdio.yaml"],
"env": {
"HA_URL": "http://homeassistant.local:8123",
"HA_TOKEN": "your-token-here"
}
}
}
}





