How to Use the Home Assistant MCP in Windsurf

Q: How do I link Home Assistant to Windsurf?

Add the server configuration to your mcpconfig.json file. Once you refresh the MCP panel, Windsurf detects the tools and makes them available to Cascade.

Q: Can Windsurf trigger my Home Assistant scenes?

Yes. Use the callhaservice tool with the scene domain. Cascade can fire these scenes as part of a multi-step workflow.

Q: What happens if my Home Assistant connection drops?

The server returns an error. Use getapistatus to verify your connection before running critical automation tasks.

Control your home directly from Windsurf. Trigger automations and query sensor states without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Home Assistant MCP to Windsurf

Create your Vinkius account to connect Home Assistant to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Home Assistant with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous home automation in Windsurf

Cascade reads your current project context to propose smart home actions. It uses `call_ha_service` to adjust lights or climate based on your code activity. Stop switching windows to fix your smart home. Windsurf chains these requests to ensure your environment matches your development session.

Real-time state monitoring for Windsurf

Query your local sensors using `get_entity_state` to pull live data into your workspace. It fetches specific values for temperature, humidity, or power consumption instantly. Feed this data into your scripts or local tests. You get an accurate view of your living space without ever opening a browser dashboard.

Explore your Home Assistant MCP Server

Discover every available device and service by running `list_entity_states` and `list_available_services`. This reveals the exact entity IDs and capabilities currently active in your home. Use this to map out your infrastructure. Once you know your entities, you can build complex automation sequences that Windsurf executes reliably.

Setup guide

Set up Home Assistant MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Home Assistant MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Home Assistant payment history." If connected, Cascade will call the Home Assistant tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "home-assistant-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Home Assistant. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Home Assistant now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Home Assistant MCP in Windsurf

Add the server configuration to your `mcp_config.json` file. Once you refresh the MCP panel, Windsurf detects the tools and makes them available to Cascade.

Yes. Use the `call_ha_service` tool with the scene domain. Cascade can fire these scenes as part of a multi-step workflow.

No. The MCP server connects directly to your instance via a long-lived access token. It talks to your local network without extra middleware.

The server returns an error. Use `get_api_status` to verify your connection before running critical automation tasks.

Your entity states and event logs stay local to your machine. The data flows only between your instance and the Windsurf process.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.