Schema | Home Assistant MCP

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`HA_URL`	No	URL of your Home Assistant instance	http://homeassistant.local:8123
`HOME_ASSISTANT_TOKEN`	Yes	Your Home Assistant Long-Lived Access Token

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

Name Description

Name	Description
control_device	Control a Home Assistant entity by turning it on or off. `Args: entity_id: The Home Assistant entity ID to control (format: domain.entity) state: The desired state ('on' or 'off')`
search_entities	Search for Home Assistant entities matching a natural language description. `Args: description: Natural language description of the entity (e.g., "office light", "kitchen fan") Returns: A list of matching entity IDs with their friendly names, or an error message`
set_device_color	Set the color and optionally brightness of a light entity. `Args: entity_id: The Home Assistant entity ID to control (format: light.entity) red: Red component (0-255) green: Green component (0-255) blue: Blue component (0-255) brightness: Optional brightness level (0-255)`

control_device

Control a Home Assistant entity by turning it on or off.

Args:
    entity_id: The Home Assistant entity ID to control (format: domain.entity)
    state: The desired state ('on' or 'off')

search_entities

Search for Home Assistant entities matching a natural language description.

Args:
    description: Natural language description of the entity (e.g., "office light", "kitchen fan")

Returns:
    A list of matching entity IDs with their friendly names, or an error message

set_device_color

Set the color and optionally brightness of a light entity.

Args:
    entity_id: The Home Assistant entity ID to control (format: light.entity)
    red: Red component (0-255)
    green: Green component (0-255)
    blue: Blue component (0-255)
    brightness: Optional brightness level (0-255)

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

Home Assistant MCP

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API