Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use ESPHome with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Control and monitor your ESPHome-powered IoT devices directly from any AI agent via the Web Server API.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 10 capabilities

The complete ESPHome capability set.

These are the exact actions your AI can choose when you ask it to work with ESPHome.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through ESPHome.

  1. 01

    Get metrics

    Get Prometheus metrics from the ESPHome device

  2. 02

    Switch action

    Perform an action on a switch entity

  3. 03

    Get entity state

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

  4. 04

    Alarm action

    Perform an action on an alarm control panel

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through ESPHome.

  1. 05

    Button press

    Press a button entity

  2. 06

    Cover action

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

  3. 07

    Fan action

    Perform an action on a fan entity

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through ESPHome.

  1. 08

    Light action

    Perform an action on a light entity

  2. 09

    Number set

    Set a value for a number entity

  3. 10

    Select option

    Set an option for a select entity

Observed, not estimated

918ms average. Fast in production.

ESPHome is checked daily against the live service.

Daily averagePeak 1137ms
Aug 20Today
Fastest day
760ms
Slowest day
1137ms
14-day trend
Slowing+20%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of ESPHome, so you can see the experience inside your AI.

It does not authenticate your account with ESPHome. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

ESPHome Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ESPHome capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "esphome-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions ESPHome owners ask.

  • 01

    Can I control my lights and set specific colors using this server?

    Yes! Use the light_action capability. 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.

  • 02

    How do I check the current temperature or humidity from my sensors?

    Simply use the get_entity_state capability. Provide the domain (e.g., 'sensor') and the entity ID. The agent will return the current value and state of that specific hardware component.

  • 03

    Is it possible to trigger a physical button or restart a device?

    Yes. If you have a button entity configured in ESPHome (like a restart button), you can use the button_press capability with the entity name to trigger that action remotely.

Explore

More in Loved By Devs

Suggestions