Netatmo Energy

Netatmo Energy MCP

英語 | フランス語

Netatmo スマートサーモスタットとスマートラジエーターバルブ向けの Netatmo MCP サーバーです。暖房に関する以下の情報へ、AI アシスタントから構造化された形でアクセスできます。

• 各部屋の温度と設定温度
• 暖房需要とボイラーの稼働状況
• 温度履歴
• 決定論的な暖房分析
• 週間暖房スケジュール
• オプションの暖房制御：各部屋の設定温度、不在モード／凍結防止モード、スケジュール。変更はすべてお客様の確認後に反映されます

お使いのマシン上で動作し、公式の Netatmo Energy API のみと通信します。デフォルトでは読み取り専用です。ログイン時に書き込みモードを有効にした場合に限り、暖房を変更できます。

ローカルサーバーを実行できるModel Context Protocol対応クライアントなら、モデルを問わず利用できます。

• Claude：Claude Desktop、Claude Code
• GPT / OpenAI：Codex CLI、VS Code + GitHub Copilot、Cursor
• Gemini：Gemini CLI、VS Code + GitHub Copilot
• マルチモデルクライアント経由のMistral など
• ローカル LLM（Llama、Qwen、Mistral、DeepSeek など）：LM Studio、および Goose、Continue、Cline、AnythingLLM、LibreChat、Open WebUI 経由の Ollama

Windsurf / Devin Desktop、Zed、Roo Code、Kilo Code、JetBrains AI Assistant、Kiro、Warp でも利用できます。互換性のあるクライアント一覧をご覧ください。

ウェブ版およびモバイル版の ChatGPT と Claudeは、リモートサーバーのみを受け付けます。これらで利用するには、オプションのリモートサーバーをお客様の Cloudflare アカウント（無料プラン）にデプロイしてください。

ステータス：初期リリース（0.3.2）。 Netatmo API との連携は実際の設置環境で検証済みです。フィードバックやデバイスに関する報告をお待ちしています。

このプロジェクトの目的

Netatmo の暖房システムには、次のような便利なデータが記録されています。

• 各部屋の温度と設定温度
• 各ラジエーターバルブが求めている暖房量
• ボイラーに暖房が要求された時刻

こうしたデータは Netatmo アプリ内に閉じ込められており、確認はできますが、質問することはできません。

このプロジェクトは、Netatmo Energy API と MCP 対応の AI アシスタントをつなぐ小さな橋渡し役です。「昨夜、最も寒かった部屋はどこ？」のように自然な言葉で質問すると、アシスタントが適切なツールを呼び出し、お客様のデータに基づいて回答します。推測はしません。書き込みモードを有効にすれば、「寝室を午前7時まで19 °Cに設定して」と指示し、変更を確認することもできます。

他の Netatmo MCP サーバーの多くは、Netatmo の気象観測所を対象としています。このサーバーは、サーモスタット、ラジエーターバルブ、暖房履歴向けに作られています。比較についてはdocs/research.mdをご覧ください。

機能

• 検出： ホーム、部屋、サーモスタット、スマートラジエーターバルブ、リレー、ゲートウェイ。
• 現在の状態
  • 部屋ごと：温度、設定温度、設定温度モード、暖房需要。
  • ボイラーのオン／オフと窓開放の検出。
  • デバイスの状態：バッテリー、無線／Wi-Fi 信号、到達可能性。
• 履歴
  • 部屋の温度と設定温度の履歴（解像度は30分から1か月）。
  • ボイラーの稼働履歴（Netatmo サーモスタットを設置している場合）。
  • 長期間のデータは分割して取得し、要約するため、回答は簡潔です。
  • 欠損箇所はそのまま報告し、補完しません。
• 暖房分析。 これらは決定論的な計算であり、数値の算出に AI モデルは使用しません。
  • 部屋ごとの統計。
  • 設定温度を下回った時間、設定温度内だった時間、設定温度を上回った時間。
  • 最大の温度低下と冷却速度。
  • 部屋のランキング。
  • 重大度と信頼度を含む、ルールベースの異常値検出。
• 週間スケジュール： ゾーン（Comfort、Night、Eco など）、ゾーンごとの部屋の設定温度、時刻表を読みやすい曜日と時刻で表示します。
• 暖房制御（オプトインの書き込みモード）
  • 必ず終了する一時的な部屋の設定温度（デフォルトは3時間、最長24時間）、またはスケジュールへの復帰。
  • ホームモード：スケジュール、不在、凍結防止。終了日を指定することもできます。
  • 週間スケジュールの切り替え、作成、編集、名前の変更。
  • 変更はすべて事前に確認でき、明示的な承認が必要です。デフォルトでは温度を7～28 °Cに制限します。
• 読み取り専用 MCP ツール15個、暖房制御ツール6個、リソース4個、プロンプト4個（日次レポート、異常値の確認、部屋の比較、暖房パターンの確認）。
• 簡単なセットアップ
  • login コマンド1つで OAuth2 ブラウザーログイン。
  • トークンは安全に保存され、自動的に更新されます。
  • doctor でセットアップを確認できます。

クイックスタート

Node.js 22.19以降と、Energy デバイスを登録した Netatmo アカウントが必要です。

1. 無料の Netatmo デベロッパーアプリを作成する

1. https://dev.netatmo.com/apps にアクセスし、Create を選択します。
2. redirect URI を http://localhost:8977/callback に設定します。
3. 手順2で使う client ID と client secret を控えておきます。

手順を追ったガイド：docs/authentication.md。

2. ログインする

npx -y netatmo-energy-mcp login

login を実行すると、client ID と secret の入力を求められます。その後ブラウザーが開くので、netatmo.com にサインインして読み取り専用アクセスを承認してください。アシスタントに暖房を変更させるには、代わりに login --write を実行します（書き込みモードを参照）。続いて、セットアップを確認します。

npx -y netatmo-energy-mcp doctor

ソースから実行する場合： リポジトリをクローンし、pnpm install && pnpm build を実行してから、npx -y netatmo-energy-mcp の代わりに node /path/to/netatmo-energy-mcp/dist/index.js を使用します。

3. AI アシスタントを接続する

ほとんどのクライアントでは、同じ mcpServers JSON ブロックを使用します。Claude Desktop、Cursor、Windsurf / Devin Desktop、Cline、Roo Code、Kiro、LM Studio、JetBrains AI Assistant、AnythingLLM、Warp、Gemini CLI で動作します。

{
  "mcpServers": {
    "netatmo-energy": {
      "command": "npx",
      "args": ["-y", "netatmo-energy-mcp"]
    }
  }
}

コマンドラインクライアント：

# Claude Code
claude mcp add --transport stdio --scope user netatmo-energy -- npx -y netatmo-energy-mcp
# OpenAI Codex CLI
codex mcp add netatmo-energy -- npx -y netatmo-energy-mcp
# GitHub Copilot CLI
copilot mcp add netatmo-energy -- npx -y netatmo-energy-mcp

Claude Code プラグイン。 claude mcp add の代わりに、プラグインをインストールします。プラグインをインストールすると、サーバーに加えて、冷えた部屋の診断、暖房レポートの作成、安全な暖房変更の方法を Claude に教えるスキルも追加されます。Claude Code 内で次を実行します。

/plugin marketplace add christophe77/netatmo-energy-mcp
/plugin install netatmo-energy@netatmo-energy-mcp

examples/claude-code を参照してください。

VS Code + GitHub Copilot。 これを .vscode/mcp.json に追加してください。servers キーを使用する点に注意してください。

{
  "servers": {
    "netatmo-energy": { "type": "stdio", "command": "npx", "args": ["-y", "netatmo-energy-mcp"] }
  }
}

これらのファイルにシークレットを保存する必要はありません。login によって、ユーザー設定フォルダーに保存されています。各クライアントのファイルの場所と、Zed、Continue、Goose、LibreChat、Kilo Code、Msty、Open WebUI の設定については、examples/ を参照してください。

4. 質問する

「今、各部屋の温度は何度ですか？」

質問の例

ツールは、次のような質問に答えられるように作られています。どのツールを使うかはアシスタントが選択し、この表に各質問に答えるツールを示しています。

質問	使用するツール
「寝室の温度は何度ですか？設定温度に達していますか？」	netatmo_get_room_status
「ボイラーは現在稼働していますか？どの部屋が暖房を要求していますか？」	netatmo_get_heating_status
「昨日、ボイラーはどれくらい稼働しましたか？」	netatmo_get_boiler_history
「過去7日間のリビングの温度を表示してください。」	netatmo_get_temperature_history
「過去1週間の各部屋を比較してください。最も早く冷えるのはどの部屋ですか？」	netatmo_compare_rooms
「昨夜、暖房にいつもと違う動きがありましたか？」	netatmo_detect_anomalies
「昨日の暖房レポートを作成してください。」	プロンプト heating_daily_report → netatmo_get_heating_summary
「バルブの電池残量が少ないものはありますか？」	netatmo_get_device_status
「週間スケジュールを見せてください。」	netatmo_get_schedules
書き込みモード：「オフィスを2時間、21 °Cにしてください。」	netatmo_set_room_setpoint
書き込みモード：「日曜日の夜まで不在にします。」	netatmo_set_home_mode
書き込みモード：「すべての寝室で、夜間ゾーンを17 °Cに下げてください。」	netatmo_get_schedules → netatmo_update_schedule

ボイラーの「稼働時間」とは、サーモスタットが暖房を要求した時間です。Netatmoはガスやエネルギーの消費量を測定しないため、このプロジェクトが消費量を報告することはありません。

利用可能な MCP ツール

読み取り専用ツールに必要なのは、read_thermostat OAuth スコープのみです。引数と出力を含む完全なリファレンスは、サーバー自体から生成されます：docs/tools.md。

ツール	説明
netatmo_list_homes	Energy デバイスがあるホーム、部屋数とデバイス数
netatmo_get_home	ホームの詳細：暖房モード、スケジュール、部屋、デバイス
netatmo_list_rooms	ID、種類、デバイスを含む部屋一覧
netatmo_list_devices	サーモスタット、バルブ、リレー：モデル、部屋、ゲートウェイ
netatmo_get_home_status	各部屋の現在の状態、ボイラーの状態、アラート
netatmo_get_room_status	1 部屋の現在の温度と設定温度
netatmo_get_heating_status	ボイラーのオン／オフ、暖房を要求している部屋
netatmo_get_device_status	バッテリー、信号、接続状況、ファームウェア
netatmo_get_temperature_history	統計情報と欠損箇所を含む部屋の温度履歴
netatmo_get_setpoint_history	部屋の設定温度の履歴と設定温度の期間
netatmo_get_boiler_history	1 時間／日／週あたりのボイラーの暖房要求時間
netatmo_get_heating_summary	期間中の部屋ごとの快適性指標とボイラー稼働時間
netatmo_compare_rooms	部屋の指標と順位
netatmo_detect_anomalies	重大度、信頼度、根拠を含む異常な測定値
netatmo_get_schedules	週間スケジュール：ゾーン、部屋の設定温度、時間割

書き込みモードのみ。 変更のたびに確認が必要です。

ツール	説明
netatmo_set_room_setpoint	一時的な部屋の設定温度またはブースト、あるいはスケジュールに戻す
netatmo_set_home_mode	スケジュール、不在、凍結防止モード。終了日も指定できます
netatmo_switch_schedule	別の週間スケジュールを有効にする
netatmo_create_schedule	既存のスケジュールをコピーし、変更を加えた新しいスケジュール
netatmo_update_schedule	ゾーンごとの部屋の設定温度、不在時／凍結防止温度、時間割
netatmo_rename_schedule	スケジュールの名前を変更（実験的：未文書化のエンドポイント）

リソース：netatmo://homes および netatmo://homes/{homeId}/rooms、 …/devices および …/status。

書き込みモード（暖房制御）

書き込みモードはデフォルトでオフです。有効にするには、次のコマンドで再度ログインしてください。

npx -y netatmo-energy-mcp login --write

これにより、write_thermostat OAuth スコープも要求されます。MCP クライアントを再起動すると、暖房制御ツールが表示されます。

安全対策：

• すべての変更を確認します。 MCP のエリシテーションに対応しているクライアントでは、直接確認を求められます。それ以外のクライアントでは、最初の呼び出しでプレビューと一度限りのトークンのみが返されます。アシスタントはプレビューを表示し、再度呼び出す前にユーザーの同意を得る必要があります。それまでは Netatmo に何も送信されません。この2つ目のフローは、アシスタントが指示に従うことを前提としています。クライアントに表示される確認プロンプトを通じてのみ変更を許可するには、NETATMO_MCP_CONFIRM=elicitation を設定してください。何も表示せずにすべての変更をキャンセルするクライアントの場合は、NETATMO_MCP_CONFIRM=token を設定してください。
• 制限。 温度は 7～28 °C の範囲内にする必要があります。手動設定温度は、デフォルトでは3時間後に終了し、最長24時間です。これらの値は NETATMO_MCP_MIN_TEMP、NETATMO_MCP_MAX_TEMP、NETATMO_MCP_MAX_SETPOINT_HOURS で変更できます。
• 緊急停止スイッチ。 NETATMO_MCP_WRITE=0 を設定すると、書き込み可能なログインを使用していても読み取り専用モードになります。
• 監査ログ。 適用された変更、または失敗した変更はすべて、設定フォルダー内の changes.log に追記されます。
• 自動再試行なし。 書き込みに失敗しても、確認なしに再送信されることはありません。

Netatmo にはスケジュールを削除する API がありません。ここで作成したスケジュールは、Netatmo アプリでのみ削除できます。スケジュールの名前変更と、ホームモードが「schedule」のスケジュールの選択には、非公開の Netatmo パラメーターを使用するため、実験的機能として扱われます。詳細はdocs/configuration.mdをご覧ください。

Web とモバイル（リモートサーバー）

ローカルサーバーが最も簡単でプライバシーに優れた方法です。ChatGPT や Claude を Web またはスマートフォンから使って暖房を操作するには、同じツールをご自身の Cloudflare アカウント（無料プラン）上のリモートサーバーとしてデプロイしてください：remote/README.md。

• 同じツールと安全対策。 デフォルトでは読み取り専用です。プレビュー、確認、同じ制限を備えた書き込みモードも利用できます。
• シークレットはご自身のアカウントに保存されます。 Netatmo アプリの認証情報とトークンは、ご自身の Cloudflare アカウント内で保存時に暗号化されます。
• アシスタントは OAuth でサインインします。 所有者のパスワードを使って同意ページで各アシスタントを承認できます。承認は取り消すこともできます。
• ご自宅を連携するコマンドは1つだけです： npx netatmo-energy-mcp remote setup <your-worker-url>.
• 任意： 招待コード（ONBOARDING=invite）を使って、家族や友人がそれぞれの Netatmo アカウントを接続できるようにします。各アカウントから閲覧できるのは、そのアカウントに紐づく自宅のみです。

サインインフローは、ChatGPT（デスクトップとモバイル）および Claude（Web、デスクトップ、モバイル）で検証済みです。設計については、ADR-0013とADR-0014をご覧ください。

対応デバイス

デバイス	Netatmo タイプ	状態
Smart Thermostat	NATherm1	テスト済み。 稼働中の環境で API を検証済み（2026-10-08）
Smart Radiator Valve	NRV	テスト済み。 同じ環境で検証済み（バルブ6台）
Thermostat Relay	NAPlug	テスト済み。 同じ環境で検証済み
OpenTherm Modulating Thermostat / Gateway	OTM / OTH	動作する見込みですが、未テスト
BTicino Smarther with Netatmo	BNS	v0.1 では未対応（おそらく read_smarther スコープが必要です）

netatmo-energy-mcp probe を実行し、デバイス互換性レポートを作成して、この表の拡充にご協力ください。probe の出力からは機密情報が除去されます。

対応するAIアシスタントとMCPクライアント

これは標準的なローカル（stdio）MCP サーバーであり、特定のAIベンダーに限定されません。ローカルサーバーを起動できるMCPクライアントであれば、そのクライアントが実行するモデルを問わず利用できます。

クライアント	モデル
Claude Desktop, Claude Code	Claude
OpenAI Codex CLI	OpenAI GPT models
Gemini CLI	Google Gemini
VS Code + GitHub Copilot (agent mode), GitHub Copilot CLI	GPT, Claude, Gemini and other Copilot models
Cursor, Windsurf / Devin Desktop, Zed, Warp, Kiro, JetBrains AI Assistant	複数のホスト型モデル
Cline, Roo Code, Kilo Code, Continue	ローカルモデル（Ollama, LM Studio）を含む複数のモデル
LM Studio	ローカルのオープンモデル：Llama, Qwen, Mistral, DeepSeek, …
Goose, AnythingLLM, LibreChat, Msty Studio	Ollamaを含む多数のプロバイダー
Open WebUI	mcpoプロキシ経由でOllamaなどを利用

各クライアントの設定は、公式ドキュメントに照らして確認済みです： examples/。

Webおよびモバイルのアシスタント（ChatGPTアプリとコネクター、Claude.ai、およびClaudeとChatGPTのモバイルアプリ）は、リモート MCP サーバーのみを受け付けます。これらにはリモートサーバーを使用してください。Mistral Le Chatはテストしていません。

テスト。 このサーバーは、公式MCP SDKクライアントとMCP Inspectorを使ってテストされています。小型のローカルモデルでは、ツール呼び出しの品質はモデルによって異なります。特定のクライアントで問題が発生した場合は、ご報告ください。

認証

このプロジェクトでは、NetatmoのOAuth2認可コードフローを使用しています。netatmo.comでサインインします。このツールがNetatmoのパスワードを確認することはありません。

スコープ。 デフォルトではread_thermostatのみが要求されるため、トークンが漏洩しても暖房設定を変更することはできません。login --writeを実行すると、write_thermostatも要求されます。

独自のアプリ。 各ユーザーは無料のNetatmo開発者アプリを登録します。クライアントシークレットをオープンソースコードに同梱することはできません。

更新。 アクセストークンは自動的に更新されます。複数のMCPクライアントを同時に実行している場合は、ロックファイルを介して連携するため、互いのトークンを無効化しません。

詳細：docs/authentication.md。

プライバシーとセキュリティ

マシンの外部に送信される情報。 api.netatmo.comへのHTTPSリクエストのみです。読み取り専用モードでは、4つの読み取りエンドポイントにしかアクセスしません。クライアントはネットワークに接続する前にすべての書き込みを拒否し、テストでもこれを確認しています。書き込みモードでは、変更は確認後にのみ送信されます。

ローカルに保存される情報。

• 認証情報はユーザー設定フォルダー内のcredentials.jsonに保存され、アクセスできるのはご自身のアカウントのみです（macOS/Linuxでは0600、Windowsでは制限付きACL）。
• テレメトリー、分析、サードパーティーサービスは使用しません。
• サーバーはstdioを介してMCPクライアントと通信し、ネットワークポートを開きません。

AIプロバイダー。 ツールが返すデータは、使用するアシスタントが読み取るため、そのモデルプロバイダーによって処理されます。

アカウント情報や位置情報は含まれません。 メールアドレスや自宅の座標が返されることはありません。

詳しくはこちら：

• セキュリティモデル
• リリース前のセキュリティレビュー
• 脆弱性の報告
• プライバシーポリシー

アーキテクチャ

Netatmo クライアントと分析機能は、MCP から独立しています。設計上の 決定は ADR に記録されており、 docs/architecture.md で各レイヤーについて説明しています。

制限事項

これらの制限は Netatmo Energy API に起因します。詳細は docs/api-capabilities.md をご覧ください。

• エネルギーやガスの消費量は取得できません。 ボイラーの稼働状況は熱需要の 時間です。集計データからバーナーのサイクル数を 知ることはできません。
• バルブの暖房需要の履歴は取得できません。 現在の値のみ 利用できます。将来的に、オプトイン方式の収集機能で記録できるようにする可能性があります （ADR-0011）。
• Energy API では屋外気温を取得できません。 天候情報の追加は v0.4 で 予定されています。
• 履歴の解像度は最良でも 30 分です。 各リクエストで返される値は 最大 1024 件のため、長期間のデータにはより粗いスケールが使われます。
• ドキュメントの記載が API と一致しない箇所があります。 ライブデータから、 ボイラーの計測値の単位は、ドキュメントに記載されている分ではなく秒であることが わかっています。このプロジェクトでは単位を変換します。
• レート制限があります。 Netatmo はユーザーごとおよびアプリごとにリクエストを制限します。 サーバーはリクエストを自らスロットリングし、トポロジーと現在の状態をキャッシュします。

ロードマップ

バージョン	重点項目
v0.1	読み取り専用の MCP サーバー
v0.2	スケジュール、オプトイン方式の暖房制御
v0.3	ウェブとモバイル向けのリモートサーバー（現行）
v0.3.x	より充実した診断機能
v0.4	天候情報（Open-Meteo）
v0.5–v0.7	熱モデリング、予測、デジタルツイン
v1.0	安定したインターフェース

書き込みモードがデフォルトで有効になることはありません。 docs/roadmap.md をご覧ください。

コントリビューション

バグ報告、デバイスの互換性に関する報告、プルリクエストを歓迎します。 API のモック応答で動作するプロジェクトのセットアップ方法については CONTRIBUTING.md をご覧ください。Netatmo アカウントは不要です。 行動規範を遵守してください。

ライセンス

Apache-2.0

免責事項

これは独立したオープンソースプロジェクトです。Netatmo または Legrand との提携、 推奨、スポンサー関係はありません。「Netatmo」はその所有者の商標であり、 ここでは互換性を示す目的でのみ使用しています。自己責任でご利用ください。 暖房の安全性を AI アシスタントに委ねてはなりません。