# Shelly Smart Home

> Shelly Smart Home is an open-source MCP server for smart home. Local-first control, energy readings and automation for Shelly smart-home devices. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/buggy1111/shelly-mcp
- **MCP Registry name:** io.github.Buggy1111/shelly-mcp
- **Categories:** [smart home](https://ai-powered.com/categories/smart-home), [energy and smart home](https://ai-powered.com/categories/energy-and-smart-home)
- **Listing updated:** 2026-11-18

## About

The server talks straight to Shelly devices on your network, covering generations 1 to 4, with auto-discovery over mDNS. The README says nothing leaves your machine except calls to your own devices, and to your own Shelly Cloud account if you turn on the optional cloud fallback, which supports control and status but not schedules, scripts, webhooks or key-value storage.

Beyond switching, lights and covers, it reads live and historical energy and exposes the Gen2+ automation surface: schedules, webhooks, on-device scripts, virtual components and named multi-device scenes. Reads are marked safe, mutations are audit-logged, and destructive actions such as raw writes need confirm: true, with a second gate for factory resets, so a hijacked model cannot silently wipe a device. Scenes only accept plain control methods.

It is an unofficial, alpha-stage community project, MIT licensed, and not affiliated with Shelly.

## Features

- **Gen1 to Gen4 support:** One tool surface across Shelly device generations.
- **Local-first:** Direct LAN calls with an optional cloud fallback.
- **Energy monitoring:** Live readings and history.
- **Automation tools:** Schedules, webhooks, scripts, KVS and virtual components.
- **Named scenes:** Run saved multi-device routines by name.
- **Safety gates:** Confirmation flags and audit logging for changes.

## Good for

- Turn off the lights in a named room
- Report energy use across devices
- Define a film-night scene and run it by name
- Diagnose an unreachable device
- Inspect device components and RPC methods

## Install

### Claude Code (Terminal)

```sh
claude mcp add shelly-mcp -- uvx shelly-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shelly-mcp": {
      "command": "uvx",
      "args": [
        "shelly-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shelly-mcp": {
      "command": "uvx",
      "args": [
        "shelly-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "shelly-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shelly-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shelly-mcp": {
      "command": "uvx",
      "args": [
        "shelly-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shelly-mcp": {
      "command": "uvx",
      "args": [
        "shelly-mcp"
      ]
    }
  }
}
```

## Tools

- `shelly_discover`: Discover devices on the local network
- `shelly_list_devices`: List known devices
- `shelly_get_status`: Get normalised device status
- `shelly_switch_set`: Set a switch
- `shelly_switch_toggle`: Toggle a switch
- `shelly_light_set`: Set a light (RGBW, CCT or white)
- `shelly_cover_move`: Move a cover
- `shelly_energy_live`: Live energy readings
- `shelly_energy_history`: Energy history
- `shelly_rpc`: Read-only generic RPC call
- `shelly_rpc_write`: Mutating RPC call with confirmation gates
- `shelly_scene_run`: Run a named scene
- `shelly_schedule_create`: Create a schedule

## FAQ

### Is it official?

No, the README says it is an unofficial community project not affiliated with Shelly.

### Does data leave my network?

No, beyond calls to your own devices and your own Shelly Cloud account if enabled.

### How do I install it?

uvx shelly-mcp or pip install shelly-mcp.

### Does discovery work in WSL or containers?

Usually not, so configure device IPs in the config file.

### Is Shelly Smart Home free?

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

### How do I add Shelly Smart Home to Claude Code?

Run this command in your terminal: claude mcp add shelly-mcp -- uvx shelly-mcp

### What are the best alternatives to Shelly Smart Home?

The closest alternatives to Shelly Smart Home are Openei Urdb, Entso E, Home Automation Mcp, myIO and Gumball.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Openei Urdb](https://ai-powered.com/mcp/openei-urdb): Openei Urdb is a freemium MCP server for energy and smart home.
- [Entso E](https://ai-powered.com/mcp/entso-e): Entso E is a freemium MCP server for energy and smart home.
- [Home Automation Mcp](https://ai-powered.com/mcp/home-automation-mcp): Home Automation Mcp is a freemium MCP server for smart home.
- [myIO](https://ai-powered.com/mcp/myio): myIO is an open-source MCP server for smart home.
- [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.

---
Source: https://ai-powered.com/mcp/shelly-smart-home
