# myIO

> myIO is an open-source MCP server for smart home. Ask Claude about and control a myIO smart home controller: heating, blinds, lighting. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://myio.hu/en/
- **Repository:** https://github.com/smarthomeninja/myio-mcp
- **MCP Registry name:** io.github.SmarthomeNinja/myio-mcp
- **Categories:** smart home, energy and smart home
- **Listing updated:** 2026-11-15

## About

myIO is a Hungarian home controller that sits on a DIN rail and runs heating, cooling, lighting, blinds, gates and energy without needing the internet. This open-source MCP server runs on your own computer and reaches the controller over your home network through its HTTP API, so you can ask how warm each room is or tell it to lower the blinds in plain words.

You give it a dedicated myIO user, and two settings bound what it can do: the user's permission level, and a write level of state (switch only), config (the default) or admin. Tool groups can be limited with MYIO_TOOLSETS, and several controllers can be configured at once. It works with V3 (Arduino Due), V4 GIGA and V4 Opta controllers; features that only exist on V4 return a clear error on a V3.

The README warns that the server is local but the AI assistant is not: questions and what it reads, such as temperatures and output names, reach the assistant provider. Version 1.6.2 retries remote reads that the controller answers with a 503 and never repeats writes.

## Features

- **Read the house:** Ask for room temperatures, history and status in plain language.
- **Switch things:** Turn lamps on and move blinds through the controller's API.
- **Write levels:** Limit the server to state, config or admin changes.
- **Toolsets:** Load only the tool groups you need, such as house or automation.
- **Several controllers:** Configure more than one controller as a JSON list.
- **Resources and prompts:** The server also exposes MCP resources, prompts and annotations, with an optional Streamable HTTP transport.

## Good for

- Check room temperatures before bed
- Lower all upstairs blinds and switch a lamp
- Review what the controller did today
- Restart or update a V3 controller from chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add myio-mcp --env MYIO_BASE_URL='<MYIO_BASE_URL>' --env MYIO_USERNAME='<MYIO_USERNAME>' --env MYIO_PASSWORD='<MYIO_PASSWORD>' --env MYIO_SERVERS='<MYIO_SERVERS>' -- npx -y myio-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "myio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "myio-mcp"
      ],
      "env": {
        "MYIO_BASE_URL": "<MYIO_BASE_URL>",
        "MYIO_USERNAME": "<MYIO_USERNAME>",
        "MYIO_PASSWORD": "<MYIO_PASSWORD>",
        "MYIO_SERVERS": "<MYIO_SERVERS>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "myio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "myio-mcp"
      ],
      "env": {
        "MYIO_BASE_URL": "<MYIO_BASE_URL>",
        "MYIO_USERNAME": "<MYIO_USERNAME>",
        "MYIO_PASSWORD": "<MYIO_PASSWORD>",
        "MYIO_SERVERS": "<MYIO_SERVERS>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "myio-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "myio-mcp"
      ],
      "env": {
        "MYIO_BASE_URL": "<MYIO_BASE_URL>",
        "MYIO_USERNAME": "<MYIO_USERNAME>",
        "MYIO_PASSWORD": "<MYIO_PASSWORD>",
        "MYIO_SERVERS": "<MYIO_SERVERS>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "myio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "myio-mcp"
      ],
      "env": {
        "MYIO_BASE_URL": "<MYIO_BASE_URL>",
        "MYIO_USERNAME": "<MYIO_USERNAME>",
        "MYIO_PASSWORD": "<MYIO_PASSWORD>",
        "MYIO_SERVERS": "<MYIO_SERVERS>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "myio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "myio-mcp"
      ],
      "env": {
        "MYIO_BASE_URL": "<MYIO_BASE_URL>",
        "MYIO_USERNAME": "<MYIO_USERNAME>",
        "MYIO_PASSWORD": "<MYIO_PASSWORD>",
        "MYIO_SERVERS": "<MYIO_SERVERS>"
      }
    }
  }
}
```

## Tools

- `myio_system`: Restarts and updates a Due controller (3.12+), checking the update package against the chip ID first.

## FAQ

### Which controllers work?

V3 (firmware 3.12), V4 GIGA and V4 Opta (firmware 4.x).

### How do I install it in Claude Desktop?

Download myio-mcp.mcpb, open it, then enter the controller address, a user name and the password.

### Can it change settings or only switch things?

Set MYIO_WRITE to state, config or admin; the default is config.

### Does my data stay at home?

The server runs locally, but the AI assistant runs on its provider's servers, so what it reads reaches that provider.

### Is myIO free?

Yes. myIO is open source, so you can use and self-host it for free.

### How do I add myIO to Claude Code?

Run this command in your terminal: claude mcp add myio-mcp --env MYIO_BASE_URL='<MYIO_BASE_URL>' --env MYIO_USERNAME='<MYIO_USERNAME>' --env MYIO_PASSWORD='<MYIO_PASSWORD>' --env MYIO_SERVERS='<MYIO_SERVERS>' -- npx -y myio-mcp

### What are the best alternatives to myIO?

The closest alternatives to myIO are Gumball, THRIVE Fleet Intelligence, Spark Pack, ElectricityFinder and (iS)NEPI - National Energy Performance Index.

## Alternatives

- [Gumball](https://ai-powered.com/mcp/gumball): Gumball is an open-source MCP server for smart home.
- [THRIVE Fleet Intelligence](https://ai-powered.com/mcp/thrive-fleet-intelligence): THRIVE Fleet Intelligence is a free MCP server for energy and smart home.
- [Spark Pack](https://ai-powered.com/mcp/spark-pack): Spark Pack is a free MCP server for home services.
- [ElectricityFinder](https://ai-powered.com/mcp/electricityfinder): ElectricityFinder is a freemium MCP server for energy and smart home.
- [(iS)NEPI - National Energy Performance Index](https://ai-powered.com/mcp/is-nepi-national-energy-performance-index): (iS)NEPI - National Energy Performance Index is a paid MCP server for energy and smart home.
- [Barrio Grid](https://ai-powered.com/mcp/barrio-grid): Barrio Grid is a freemium MCP server for energy and smart home.
- [AgentDataAPI](https://ai-powered.com/mcp/agentdataapi): AgentDataAPI is a freemium MCP server for analytics and data.
- [StationSignals](https://ai-powered.com/mcp/stationsignals): StationSignals is a freemium MCP server for smart home.

---
Source: https://ai-powered.com/mcp/myio
