ESPHome Connector for AI agents.
10 live capabilities
Control your smart home and industrial IoT hardware with natural language.
Waiting for input…
Why people use ESPHome
ESPHome Smart Home Control for Automated IoT Management
This Connector changes that by turning your AI agent into a direct remote. You just tell it what you want to happen in plain English. Instead of clicking three times, you get the result in one sentence.
What Vinkius changes
You get a direct voice command bridge to your local hardware without building a custom dashboard.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
The Greenhouse Manager
A gardener asks the agent to check the soil moisture and open the vents if it's too humid.
- Real-world use case 02
The Workshop Setup
A woodworker wants to turn on the dust collection fan and dim the lights.
- Real-world use case 03
The Security Check
A homeowner asks if the alarm is set and wants to disarm it for the night.
Complete set · 10capabilities
The complete ESPHome capability set.
These are the exact actions your AI can choose when you ask it to work with ESPHome.
01—04
4 capabilities in this set.
Part of 10 available through ESPHome.
- 01 Capability
Fan action
Turn your fans on or off and manage their specific behaviors. This allows for easy climate control through your agent.
- 02 Capability
Get metrics
Pull Prometheus metrics directly from your ESPHome hardware. Use this to track performance data over time.
- 03 Capability
Light action
Control your lights, including specific brightness and color values. You can set the mood with a single sentence.
- 04 Capability
Number set
Update a specific numeric value on a device, like a target temperature. This is perfect for setting thresholds.
05—07
3 capabilities in this set.
Part of 10 available through ESPHome.
- 05 Capability
Select option
Pick a specific setting from a dropdown menu on your hardware. Use this to choose modes or presets easily.
- 06 Capability
Switch action
Toggle power to switches and other binary components. This handles any simple on or off command.
- 07 Capability
Get entity state
Check the current status of any sensor, switch, or binary device. It pulls data directly from your device's Web API.
08—10
3 capabilities in this set.
Part of 10 available through ESPHome.
- 08 Capability
Alarm action
Arm or disarm your alarm panels through your chat interface. Manage your security with a quick command.
- 09 Capability
Button press
Simulate a physical button press on your connected device. This triggers actions that require a button interaction.
- 10 Capability
Cover action
Open, close, or move covers like garage doors and blinds. You can specify positions and tilts with ease.
Set up in minutes
One URL. Then ask ESPHome to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use ESPHome from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it ESPHome, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable ESPHome for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the ESPHome URL.
- Step 03
Save and start
Save the connection and enable ESPHome in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"esphome": {
"url": "https://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using ESPHome
Open Agent mode in chat and ask: "Using ESPHome, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"esphome": {
"url": "https://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using ESPHome
Ask Copilot: "Using ESPHome, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"esphome": {
"url": "https://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using ESPHome
Open Cascade and ask: "Using ESPHome, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"esphome": {
"url": "https://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using ESPHome
Ask Cline: "Using ESPHome, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add esphome --transport http "https://edge.vinkius.com/vk_preview_5SHbIX7z5rQfgbeYq11JB03GdUqXJkasteub5KtB/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using ESPHome
Ask Claude: "Using ESPHome, show me...". 10 tools are ready
Where the request belongs
Work ESPHome can move forward.
This is for the person who is tired of clicking through complex dashboards to perform simple hardware tasks. It's for the hobbyist, the engineer, and the operator who wants to interact with their physical space using natural language.
Home Automation Enthusiast
Tired of digging through Home Assistant dashboards to turn off a single light or check a sensor.
IoT Developer
Needs to test how an ESP32 reacts to different inputs without writing constant test scripts.
Hardware Engineer
Wants to monitor real-time metrics during a long prototyping phase without a dedicated screen.
Industrial Operator
Needs to check machine status or toggle remote switches using a simple chat interface.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsParticle IoT
Access Particle IoT devices via API. read sensor variables, control device functions, manage devices, and publish events from any AI agent.
ThingsBoard
Manage your IoT ecosystem via ThingsBoard. monitor telemetry, control devices with RPC, and track alarms directly from your AI agent.
myDevices
IoT device management. monitor telemetry and control assets via myDevices Cayenne.
Golioth
Manage IoT devices and projects via Golioth. list projects, register hardware, and control LightDB state directly from your AI agent.
Tuya
Control and monitor your Tuya IoT ecosystem. query device status and send real-time commands to smart hardware via AI.
Alexa Smart Home
Control Alexa-connected smart home devices. lights, thermostats, speakers, and sensors via Alexa Smart Properties API.
Bring your own AI
Change the model, client or framework. Keep ESPHome connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about ESPHome.
The practical details behind the request, access and result.
Can I use ESPHome MCP with my existing devices?
Yes, as long as your devices are already running ESPHome and you have the web component enabled in your configuration.
Does ESPHome MCP work with Claude?
Yes, it works with any MCP-compatible client including Claude, Cursor, and Windsurf.
Is it hard to set up?
Not at all. You just need to enable one component in your configuration and provide your device's local URL.
Can I control my lights?
Yes, you can adjust brightness, colors, and power states through natural conversation.
Does it work for industrial use?
Absolutely. It's great for monitoring sensors and toggling switches in industrial environments.
How do I connect it?
You subscribe via Vinkius and enter your device's local IP address and optional password.
Is my data private?
Since it connects to your local URL, your device data stays on your local network.
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.
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.
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.
One connection away
Give your agent a direct line to ESPHome.
Connect ESPHome once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available