ホームアシスタントMCPサーバー

Home Assistantと統合し、LLM がスマートホームを制御およびクエリできるようにするModel Context Protocol (MCP)サーバー。

特徴

自然言語でHome Assistantエンティティをクエリおよび制御する
MCP 互換クライアント（Claude Desktop など）で動作します
状態管理、サービス呼び出し、履歴などのツールを提供します
Home Assistantの長期アクセストークンを使用した安全な認証
複数のトランスポートオプション (ローカルプロセスの場合は stdio、リモートクライアントの場合は SSE)
Home Assistant が利用できない場合のテストとデモンストレーション用の模擬データを備えたデモモード

インストール

# Install globally using bun
bun install -g home-assistant-mcp-server

# Or install from source
git clone https://github.com/oleander/home-assistant-mcp-server.git
cd home-assistant-mcp-server
bun install
bun run build
bun link

構成

次の変数を使用して、現在のディレクトリに.envファイルを作成します。

# Required configurations
HASS_URL=http://your-home-assistant:8123  # URL to your Home Assistant instance
HASS_TOKEN=your_long_lived_access_token   # Long-lived access token for authentication

# Optional configurations
PORT=3000                # Port for the HTTP server (default: 3000)
HASS_MOCK=false          # Enable mock data mode when Home Assistant is unavailable (default: false)

環境変数

変数	必須	デフォルト	説明
`HASS_URL`	はい	-	Home Assistant インスタンスへの URL (例: http://homeassistant.local:8123 )
`HASS_TOKEN`	はい	-	Home Assistant で認証するための長期アクセストークン
`PORT`	いいえ	3000	HTTP/SSEトランスポートを使用する場合のHTTPサーバーのポート番号
`HASS_MOCK`	いいえ	間違い	「true」に設定すると、Home Assistant接続なしでテストするための模擬データモードが有効になります

長期間有効なアクセストークンを取得するには:

Home Assistantインスタンスにログインする
プロフィール（左下）をクリックします
「長期アクセストークン」までスクロールします。
わかりやすい名前で新しいトークンを作成する
トークンの値をコピーします（再度表示されません）

使用法

スタンドアロンサーバーとして実行

# Standard mode (requires a running Home Assistant instance)
home-assistant-mcp-server                # Start with HTTP/SSE transport
home-assistant-mcp-server --stdio        # Start with stdio transport for direct process communication

# Demo mode (with mock data when Home Assistant is unavailable)
home-assistant-mcp-server --mock         # Start with HTTP/SSE transport and mock data
home-assistant-mcp-server --stdio --mock # Start with stdio transport and mock data

Claude Desktopとの統合

Claude Desktop で使用するには:

Claude Desktop の設定ファイルを編集します。
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
サーバー構成を追加します。

{
  "mcpServers": {
    "homeassistant": {
      "command": "home-assistant-mcp-server"
      "env": {
        "HASS_URL": "http://your-home-assistant:8123",
        "HASS_TOKEN": "your_token_here",
        "HASS_MOCK": "true"
      }
    }
  }
}

Home Assistant を実行している場合は、 --mockフラグを削除し、 HASS_MOCK falseに設定するだけです。

Claudeデスクトップを再起動します

利用可能なツール

サーバーは、Home Assistant と対話するためのいくつかのツールを公開します。

states - エンティティの状態を照会する
lights - ライトの一覧
light - ライトを制御する
service - ホームアシスタントサービスに電話する
history - 履歴エンティティデータを取得する
services - 利用可能なサービスを一覧表示する
config - Home Assistantの設定を取得する
domains - 利用可能なドメインの一覧
error_log - Home Assistant のエラーログを取得する
devices - Home Assistantですべてのデバイスを取得する

詳細な使用例については、 docs/hass-mcp.md を参照してください。

安全

このサーバーには、フルアクセス権限を持つHome Assistantアクセストークンが必要です。以下のセキュリティ推奨事項にご留意ください。

信頼できるネットワーク上でのみサーバーを実行する
サーバーをリモートで公開する場合はHTTPSを使用する
.envファイルを安全に保ち、ソース管理にコミットしないでください。
可能な場合は、権限が制限されたトークンの使用を検討してください

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

大規模な言語モデルが自然言語による対話を通じて Home Assistant スマートホームシステムを制御およびクエリできるようにするモデルコンテキストプロトコルサーバー。

Related MCP Servers

Home Assistant MCP
allenporter
-
security
A
license
-
quality
Expose all Home Assistant voice intents through a Model Context Protocol Server allowing home control.
Last updated -
30
Python
Apache 2.0
Home Assistant MCP Server
hekmon8
A
security
A
license
A
quality
A server that enables interaction with Home Assistant devices and automations through the Model Context Protocol, allowing users to monitor device states, control devices, trigger automations, and list entities.
Last updated -
4
29
JavaScript
MIT License
MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
Home Assistant MCP Server
miguelg719
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Home Assistant to provide smart home control capabilities through natural language, supporting devices like lights, climate systems, locks, alarms, and humidifiers.
Last updated -
Python
MIT License

View all related MCP servers

Home Assistant MCP Server