Connect an AI client

What you get

Your AI client gains a set of tools about your home, nothing else: rooms, devices and states, switching and dimming, scenes, automations, history and the weather. It can answer "is anything open?", turn things off, build an automation from a sentence, or tell you where yesterday's kWh went. It understands the names you use, in your language.

1 · Create an MCP token

Settings › Access › + New token, choose An AI assistant (MCP), tick what the client may do, Create token. The sheet shows the secret and a configuration block:

{
  "mcpServers": {
    "iconet": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://iconet.local/api/mcp",
               "--header", "Authorization: Bearer ico_…"]
    }
  }
}

2 · Paste it into the client

Every MCP client has an MCP servers setting. Paste the block, restart the client, and ask it something about your home. Node.js must be installed on that computer (the npx line runs a small connector).

If the client connects to http://iconet.local directly (no npx), it must support Streamable HTTP and send the same Authorization header.

3 · Try it

• "What's on right now?"
• "Turn off every light in the kitchen."
• "Every weekday at 07:00 open the bedroom blind."
• "How much did we consume this week compared to last?"
• "Is it going to rain? Should I close the awning?"

Automations the client creates arrive as drafts in Workflows for you to review and enable.

Limits, on purpose

• Works only on your local network. From outside, nothing answers.
• Only the permissions you ticked. Control needs Control devices; reading energy needs Read trends.
• The system, files, network and updates are never exposed, whatever the client asks.
• Every call is logged in Settings › Access › Activity.