mcp-homeassistant

mcp-homeassistant

Home Assistant 2026.4.1 REST API の機能を公開する MCP サーバーです。

mcp-name: io.github.daedalus/mcp-homeassistant

インストール

pip install mcp-homeassistant

設定

以下の環境変数を設定します。

• HA_URL：Home Assistant の URL（デフォルト：http://localhost:8123）
• HA_TOKEN：長期アクセストークン（必須）

使用方法

export HA_URL="http://homeassistant:8123"
export HA_TOKEN="your_long_lived_access_token"
mcp-homeassistant

ツール

MCP サーバーは以下のツールを公開します。

• get_api_status - API が稼働しているか確認します
• get_config - HA の設定を取得します
• get_components - 読み込み済みのコンポーネントを一覧表示します
• get_events - イベントタイプとリスナー数を一覧表示します
• get_services - ドメインごとに利用可能なサービスを一覧表示します
• get_states - すべてのエンティティ状態を取得します
• get_state - 特定のエンティティ状態を取得します
• set_state - エンティティ状態を更新または作成します
• delete_state - エンティティ状態を削除します
• fire_event - カスタムイベントを発火します
• call_service - Home Assistant サービスを呼び出します
• render_template - Jinja テンプレートをレンダリングします
• get_history - 状態変更の履歴を取得します
• get_logbook - ログブックのエントリを取得します
• check_config - configuration.yaml を検証します
• handle_intent - インテントを処理します
• get_error_log - エラーログを取得します
• get_calendars - カレンダーエンティティを一覧表示します
• get_calendar_events - カレンダーイベントを取得します

リソース

• homeassistant://config - 現在の設定
• homeassistant://states - すべてのエンティティ状態
• homeassistant://services - 利用可能なサービス
• homeassistant://components - 読み込み済みのコンポーネント

開発

git clone https://github.com/daedalus/mcp-homeassistant.git
cd mcp-homeassistant
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/