Use This MCP client To

Control Home Assistant devices using voice commands Enable real-time audio/video communication with AI assistants Access and manage Home Assistant entities via MCP Integrate LiveKit voice agents with smart home automation Run voice-controlled workflows for smart home devices Use natural language to trigger Home Assistant services

README

LiveKit Agent integrated with Home Assistant MCP Server

This project integrates LiveKit Agents with Home Assistant's Model Context Protocol (MCP) Server, allowing voice control of your smart home through LiveKit agents.

Overview

This integration enables:

Voice control of Home Assistant devices through LiveKit Agents
Real-time audio/video communication with AI assistants
Access to Home Assistant entities and services via MCP

Prerequisites

Home Assistant with MCP Server integration enabled
LiveKit and OpenAI settings
Python environment for running the agent

Setup

Configure Home Assistant MCP Server following the official documentation
Set up your LiveKit agent using the LiveKit Agents framework
Configure the agent with your Home Assistant URL and access token

Configuration

# Example configuration
LIVEKIT_URL = "wss://your-livekit-server.com"
LIVEKIT_API_KEY = "your-api-key"
LIVEKIT_API_SECRET = "your-api-secret"

OPENAI_API_KEY

HOME_ASSISTANT_URL = "http://your-homeassistant:8123/mcp_server/sse"
HOME_ASSISTANT_TOKEN = "your-long-lived-access-token"

home-assistant-mcp-agent FAQ

How do I set up the home-assistant-mcp-agent?

Configure Home Assistant MCP Server, set up LiveKit Agents, then connect the agent with your Home Assistant URL and access token.

What prerequisites are needed for this agent?

You need Home Assistant with MCP Server enabled, LiveKit, OpenAI settings, and a Python environment.

Can this agent handle real-time audio and video communication?

Yes, it supports real-time audio/video communication with AI assistants.

Does this client support multiple AI providers?

Yes, it works with OpenAI, Claude, Gemini, and other MCP-compatible LLM providers.

Is this agent limited to voice control only?

Primarily designed for voice control, but it can also manage Home Assistant entities and services programmatically.

How secure is the connection between the agent and Home Assistant?

The agent uses access tokens and MCP's secure protocol to ensure scoped and secure interactions.

Can I customize the voice commands or workflows?

Yes, you can extend the LiveKit agent framework to customize commands and automate workflows.

What platforms can run the home-assistant-mcp-agent?

It runs in a Python environment, compatible with most platforms supporting Python.