Shelly Smart Home
Local-first control, energy readings and automation for Shelly smart-home devices
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"shelly-mcp": {
"command": "uvx",
"args": [
"shelly-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"shelly-mcp": {
"command": "uvx",
"args": [
"shelly-mcp"
]
}
}
}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.
