Ha Mcp

Name: Ha Mcp
Author: homeassistant-ai

by homeassistant-aicommunityv7.2.0

2.2k

The Home Assistant MCP Server is a Model Context Protocol server that allows AI assistants to interact with Home Assistant, enabling control of smart home devices and management of automations using natural language.

From the registry: Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.

GitHub Repository

Install & configure

Prerequisites

required
Install uv/uvx
uv/uvx is used to run ha-mcp
```
$ pip install uv
```
https://docs.astral.sh/uv/
required
Home Assistant instance
A reachable Home Assistant instance and a long-lived access token
https://homeassistant-ai.github.io/ha-mcp/

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `ha-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install uv/uvx** — uv/uvx is used to run ha-mcp Run: `pip install uv` (https://docs.astral.sh/uv/)
- **Home Assistant instance** — A reachable Home Assistant instance and a long-lived access token (https://homeassistant-ai.github.io/ha-mcp/)

Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["ha-mcp"]
- required environment variables:
  - `HOMEASSISTANT_URL`: Base URL of your Home Assistant instance (example: `<your-homeassistant-url>`)
  - `HOMEASSISTANT_TOKEN`: Home Assistant long-lived access token (example: `<your-homeassistant-token>`)
- optional environment variables:
  - `HAMCP_ENABLE_FILESYSTEM_TOOLS`: Enable file system tools (requires companion HA custom component) (example: `false`)
  - `ENABLE_YAML_CONFIG_EDITING`: Enable YAML editing tools (example: `false`)
  - `HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION`: Enable the installer tool for the companion component (example: `false`)

Note: Also available as a Home Assistant add-on (no token/credential setup needed) and via install scripts for macOS/Windows. Remote access via Nabu Casa or webhook proxy is supported.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Also available as a Home Assistant add-on (no token/credential setup needed) and via install scripts for macOS/Windows. Remote access via Nabu Casa or webhook proxy is supported.

Tools (5)

ha_config_set_yaml

Safely add, replace, or remove top-level YAML keys in configuration.yaml and package files.

ha_list_files

List files in allowed directories.

ha_read_file

Read files from allowed paths.

ha_write_file

Write files to allowed directories.

ha_delete_file

Delete files from allowed directories.

Environment variables

HOMEASSISTANT_URLrequiredThe URL of the Home Assistant instance.

HAMCP_ENABLE_FILESYSTEM_TOOLSrequiredEnables file tools for accessing the file system.

ENABLE_YAML_CONFIG_EDITINGrequiredEnables YAML editing capabilities.

HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATIONrequiredEnables the installation of the custom component integration.

Packages

ha-mcp

pypiv7.2.0transport: stdio

ghcr.io/homeassistant-ai/ha-mcp:7.2.0

ocitransport: stdio

Details

Language: Python
License: MIT
Released: Apr 1, 2026
Last commit: Apr 12, 2026
Registry name: io.github.homeassistant-ai/ha-mcp

Related Servers

Ros Mcp Server

Connect AI models like Claude & ChatGPT with ROS robots using MCP

1.2k

Tapo MCP

MCP server for discovering and controlling TP-Link Tapo smart home devices via AI Agents

744

UniFi Protect MCP

Manage UniFi Protect cameras, events, recordings, and smart detections via MCP.

243