mcp-server-home-assistant logo

mcp-server-home-assistant

by allenporter

A Model Context Protocol Server for Home Assistant. It enables communication between Home Assistant and applications like Claude Desktop using the Model Context Protocol.

View on GitHub

Last updated: N/A

What is mcp-server-home-assistant?

This is a Model Context Protocol (MCP) server designed to bridge Home Assistant with applications like Claude Desktop. It allows these applications to understand and interact with the context of your Home Assistant environment.

How to use mcp-server-home-assistant?

  1. Install the home-assistant-model-context-protocol custom component in your Home Assistant instance.
  2. Create a Long Lived Access Token in Home Assistant.
  3. Clone the git repo to a local directory.
  4. Edit your claude_desktop_config.json to include the server configuration, pointing to the local directory and including your Home Assistant URL and API token.
  5. View the logs to understand what is happening.

Key features of mcp-server-home-assistant

  • Enables communication between Home Assistant and Claude Desktop

  • Uses Model Context Protocol

  • Requires a Home Assistant custom component

  • Configurable via claude_desktop_config.json

Use cases of mcp-server-home-assistant

  • Integrating Home Assistant data into AI applications

  • Providing context to AI models running in Claude Desktop

  • Controlling Home Assistant devices through AI interfaces

  • Building intelligent home automation systems

FAQ from mcp-server-home-assistant

What is Model Context Protocol (MCP)?

Model Context Protocol is a standard for communicating contextual information between applications.

Why do I need a Long Lived Access Token?

The Long Lived Access Token is required for the MCP server to authenticate with your Home Assistant instance.

Where can I find the home-assistant-model-context-protocol custom component?

The custom component is available at https://github.com/allenporter/home-assistant-model-context-protocol

Where are the logs stored?

Logs are stored in a directory like ~Library/Logs/Claude/mcp-server-Home-assistant.log

What if I don't want to use Claude Desktop?

This server is specifically designed for use with Claude Desktop. Other applications may require different MCP server implementations.