esphome-mcp

01 · What it does

• esphome_list_devices: Lists all registered ESPHome devices, IP addresses, online statuses, board architectures, and YAML filenames.
• esphome_get_config: Retrieves full YAML configuration for any device (e.g. esp32-shelf.yaml).
• esphome_update_config: Saves updated YAML configurations directly to the ESPHome instance.
• esphome_validate: Validates YAML syntax & component configurations before compilation.
• esphome_compile: Triggers C++ compilation of device firmware.

02 · Install

$ git clone https://github.com/saihgupr/esphome-mcp.git

03 · Client config (Claude Desktop / Cursor, from README)

{
  "mcpServers": {
    "esphome": {
      "command": "/Users/your-username/path/to/esphome-mcp/.venv/bin/python",
      "args": [
        "/Users/your-username/path/to/esphome-mcp/server.py"
      ],
      "env": {
        "ESPHOME_HOST": "192.168.1.4",
        "ESPHOME_PORT": "6052"
      },
      "disabled": false
    }
  }
}

Commands copied from the project README. Placeholders are the maintainer's. Not bench-tested by HardwareMCP yet.