ESPHome MCP server for managing ESPHome devices directly
I tried using a couple of existing ESPHome MCP add-ons recently, but ran into some startup errors with them. Instead of running extra container infrastructure, I created a direct Python MCP server that interfaces right with ESPHome and works seamlessly with AI coding tools like Claude Code, Antigravity, and Cursor.
The nice part about this setup is that it does not require installing any extra Home Assistant add-ons. It just connects over your local network to the ESPHome dashboard you already have running.
Once connected, it lets your AI assistant:
- List your devices and see what is online
- Read and edit your device YAML files
- Check configs for errors
- Send Over-The-Air (OTA) updates over Wi-Fi
A few examples of things you can ask it in chat:
- "Check which of my ESPHome devices are currently online"
- "Show me the YAML file for esp32-shelf.yaml"
- "Update esp32-shelf.yaml so pressing the door button flashes my LED lights for half a second as feedback, check for syntax errors, and push the OTA update over Wi-Fi"
The project is completely open source (MIT license). If you'd like to try it out, open issues, or suggest features, check out the GitHub repo: https://github.com/saihgupr/esphome-mcp