ESPHome

ESPHome MCP Connector for Claude

F

Control and monitor your ESPHome-powered IoT devices directly from any AI agent via the Web Server API.

10 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect your ESPHome microcontrollers to any AI agent and take full control of your smart home or industrial IoT setup through natural conversation.

What you can do

  • Real-time Monitoring — Fetch the current state and values of any sensor, switch, or binary sensor using the get_entity_state tool.
  • Lighting Control — Manage lights with precision using light_action, including brightness and RGB color adjustments.
  • Appliance Management — Toggle switches, control fans with fan_action, and adjust covers (blinds/garage doors) with cover_action.
  • Interactive Components — Press buttons via button_press, set numeric values with number_set, and choose options from dropdowns with select_option.
  • Security & Safety — Arm or disarm alarm panels using alarm_action directly from your chat interface.

How it works

  1. Enable the web_server component in your ESPHome YAML configuration.
  2. Subscribe to this server.
  3. Enter your device's local URL and optional password.
  4. Start interacting with your hardware from Claude, Cursor, or any MCP client.

Who is this for?

  • Home Automation Enthusiasts — control your local environment without complex dashboards.
  • IoT Developers — test and debug ESP32/ESP8266 entity behaviors using natural language.
  • Hardware Engineers — monitor sensor metrics and trigger actions during prototyping phases.
esp32esp8266home-automationsmart-homemicrocontrollerssensors

10 tools expose this connector's capabilities to your AI agent.

alarm_action

Perform an action on an alarm control panel

button_press

Press a button entity

cover_action

g., blinds, garage door), optionally setting position and tilt. Perform an action on a cover entity

fan_action

Perform an action on a fan entity

get_entity_state

g., sensor, switch) using the Web Server REST API. Get the state of an ESPHome entity

get_metrics

Get Prometheus metrics from the ESPHome device

light_action

Perform an action on a light entity

number_set

Set a value for a number entity

select_option

Set an option for a select entity

switch_action

Perform an action on a switch entity

See how to talk to your AI agent using ESPHome.

What is the current reading of the 'living_room_temperature' sensor?

Checking the sensor... The current state of 'living_room_temperature' is 22.5°C.

Turn on the kitchen light and set it to a warm orange color.

I've sent the command to the kitchen light. It is now on with the RGB values set to (255, 165, 0).

Close the garage door cover.

Executing the close action on the garage door cover. The command has been sent successfully.

Yes! Use the `light_action` tool. You can specify the entity name, the action (turn_on), and optional parameters like brightness (0-255) and RGB values (r, g, b) to get the perfect ambiance.

Related Connectors