# Home Assistant MCP Server
A Model Context Protocol (MCP) server that provides access to Home Assistant entities and services.
## Features
- **List Entities**: Browse all your Home Assistant devices (lights, switches, sensors, etc.)
- **Get Entity State**: Check the current state and attributes of any entity
- **Call Services**: Control devices (turn lights on/off, adjust climate, etc.)
- **List Services**: Discover available Home Assistant services
## Installation
```bash
npm install
npm run build
```
## Configuration
Set the following environment variables:
- `HASS_HOST`: Your Home Assistant URL (e.g., `https://your-instance.ui.nabu.casa`)
- `HASS_TOKEN`: Your Home Assistant long-lived access token
## Usage with VS Code
Add to your VS Code `settings.json`:
```json
{
"github.copilot.chat.mcp.servers": {
"homeassistant": {
"command": "node",
"args": ["C:/Repos/HomeAssistant-mcp/dist/index.js"],
"env": {
"HASS_HOST": "https://your-instance.ui.nabu.casa",
"HASS_TOKEN": "your-long-lived-token"
}
}
}
}
```
## Available Tools
### list_entities
List all Home Assistant entities, optionally filtered by domain.
**Parameters:**
- `domain` (optional): Filter by domain (e.g., "light", "switch", "sensor")
### get_entity_state
Get the current state and attributes of a specific entity.
**Parameters:**
- `entity_id` (required): The entity ID (e.g., "light.living_room")
### call_service
Call a Home Assistant service to control devices.
**Parameters:**
- `domain` (required): Service domain (e.g., "light", "switch")
- `service` (required): Service name (e.g., "turn_on", "turn_off")
- `entity_id` (optional): Target entity ID
- `data` (optional): Additional service data (brightness, color, etc.)
### list_services
List all available Home Assistant services.
## License
MIT
