Skip to content
MCP server

Shelly Smart Home

Local-first control, energy readings and automation for Shelly smart-home devices

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.3
Listing updated
today

Similar MCP servers

About Shelly Smart Home

Shelly Smart Home is an open-source MCP server for smart home. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add shelly-mcp -- uvx shelly-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shelly-mcp": {
      "command": "uvx",
      "args": [
        "shelly-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shelly-mcp": {
      "command": "uvx",
      "args": [
        "shelly-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licensed; alpha

Shelly Smart Home 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.

How AIPoweredBot checks servers