# Home Assistant MCP Server

Home Assistantの非公式かつ素晴らしいModel Context Protocol（MCP）サーバーです。Claude、Cursor、GeminiなどのAIアシスタントが自然言語を使用してスマートホーム（照明、センサー、オートメーション、ダッシュボードなど）を制御できるようにします。

Canonical URL: https://a2a-mcp.org/entry/home-assistant-mcp-server-ja

Language: ja

Category: MCP Servers

Updated: 2026-04-01

## 概要

**ha-mcp** (非公式で最高の Home Assistant MCP サーバー) は、コミュニティによって構築された主要な Model Context Protocol サーバーであり、あなたの Home Assistant インスタンスを AI アシスタントのための強力なツールへと変えます。Claude、Cursor、Gemini CLI などの LLM や、MCP 互換の任意のクライアントが、自然言語を使って直接あなたのスマートホームと対話できるようにします。

現在、Home Assistant には公式の `mcp_server` インテグレーションが含まれていますが、ha-mcp はより豊富な機能（80以上のツール）、簡単な HA OS アドオン、専用のセットアップウィザードを提供しており、大多数のユーザーにとって第一選択肢となっています。

## 主な特徴

+ **自然言語制御**: ライトのオン/オフ、気候調整、カバーの開閉、メディア再生、任意のサービスの実行が可能です。
+ **リアルタイム状態 & エンティティ照会**: センサー値、デバイス状態、家庭全体の概要を尋ねることができます。
+ **オートメーション管理**: オートメーションの作成、編集、有効化/無効化、トリガー、一時停止を動的に行えます。
+ **高度な機能**: YAML 編集、HACS 管理、Lovelace ダッシュボード生成、更新処理、バックアップ、80以上の専門的なツールを備えています。
+ **マルチクライアント対応**: Claude Desktop、Cursor、VS Code + Cline、Gemini CLI などとシームレスに連携します。
+ **簡単なインストール**: 公式 HA OS アドオン、Docker、クイックランオプションが利用できます。
+ **安全 & 信頼性**: 適切な認証を伴う長寿命アクセストークンを使用します。

## ユースケース

+ **ハンズフリー・スマートホーム**: 「階下のすべての照明を消して、玄関のドアを施錠して」
+ **AI 駆動オートメーション**: 「日没にポーチライトを点灯し、通知を送るオートメーションを作成して」
+ **ダッシュボード & 設定編集**: Cursor や Claude に Lovelace ダッシュボードや YAML 設定を生成・デプロイさせることができます。
+ **モニタリング & トラブルシューティング**: 「寝室の現在の温度は？なぜモーションセンサーがオフラインなの？」
+ **複雑なワークフロー**: 他の MCP サーバーと組み合わせて、AI による完全なホーム + 開発パイプラインを実現できます。

## インストール（最も簡単な方法）

### Home Assistant OS アドオン
1. HA アドオンストアにリポジトリ `https://github.com/homeassistant-ai/ha-mcp` を追加します。
2. **Home Assistant MCP Server** アドオンをインストールして起動します。
3. 長寿命アクセストークンを生成し、設定します。
4. 公式セットアップウィザードを使用します: https://homeassistant-ai.github.io/ha-mcp/setup/

代替オプション: Docker、`uvx`、またはリポジトリからの手動インストール。

## 互換性

+ **クライアント**: Claude Desktop、Cursor、Gemini CLI、Codex、任意の MCP 準拠アプリケーション。
+ **Home Assistant**: 現在の HA バージョン（OS、コンテナ、コア）で動作します。
+ **ライセンス**: オープンソース (詳細な条件はリポジトリを確認してください)。

## コミュニティと代替手段

これは最も活発にメンテナンスされ、機能豊富なバージョンです（2026年3月現在、v7.1.0以降）。他のコミュニティフォークも存在しますが、homeassistant-ai組織によるha-mcpは、フォーラム、YouTube、Redditで最も推奨されているものです。

公式のHome Assistant `mcp_server`統合も、より軽量なユースケースに利用可能です。

AIを使ってスマートホームを操作しましょう — ha-mcpはそれをシンプルに、強力に、楽しく実現します。

## Tags

- Home Assistant
- MCP
- スマートホーム
- ホームオートメーション
- AI連携
- Claude
- Cursor
- IoT
- LLM
- オートメーション

## Sources

- [Project website](https://github.com/homeassistant-ai/ha-mcp)
