Shelly Smart Home
Local-first control for Shelly smart home devices across all generations (Gen1 through Gen4). Connects directly to devices on your LAN with ~10ms latency and full API access, plus optional cloud fallback for remote use. Beyond basic switch and light control, you get energy monitoring with history, schedule management, on-device script execution, webhooks, and a key-value store for automation. The generic RPC engine exposes every device capability, even for hardware released after the server shipped. Scene definitions let you save multi-device routines as named commands. Mutations are audit-logged and destructive operations require explicit confirmation gates to prevent accidental factory resets or data loss.
- tools
- 20
- transport
- STDIO
- last updated
- Oct 16, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
shelly_versionRead (safe) tool.
Read (safe) tool.
No parameter schema in public metadata yet.
shelly_discoverRead (safe) tool.
Read (safe) tool.
No parameter schema in public metadata yet.
shelly_list_devicesRead (safe) tool.
Read (safe) tool.
No parameter schema in public metadata yet.
shelly_get_infoRead (safe) tool.
Read (safe) tool.
No parameter schema in public metadata yet.
shelly_get_statusRead (safe) tool returning normalized status.
Read (safe) tool returning normalized status.
No parameter schema in public metadata yet.
shelly_get_configRead (safe) tool with credentials masked.
Read (safe) tool with credentials masked.
No parameter schema in public metadata yet.
shelly_list_componentsRead (safe) tool.
Read (safe) tool.
No parameter schema in public metadata yet.
shelly_list_methodsRead (safe) tool.
Read (safe) tool.
No parameter schema in public metadata yet.
shelly_switch_setControl tool (audited).
Control tool (audited).
No parameter schema in public metadata yet.
shelly_switch_toggleControl tool (audited).
Control tool (audited).
No parameter schema in public metadata yet.
shelly_light_setControl tool (audited) for RGBW/CCT/white lights.
Control tool (audited) for RGBW/CCT/white lights.
No parameter schema in public metadata yet.
shelly_cover_moveControl tool (audited).
Control tool (audited).
No parameter schema in public metadata yet.
shelly_energy_liveEnergy monitoring tool for live data.
Energy monitoring tool for live data.
No parameter schema in public metadata yet.
shelly_energy_historyEnergy monitoring tool for history data.
Energy monitoring tool for history data.
No parameter schema in public metadata yet.
shelly_rpcGeneric engine tool (read-only).
Generic engine tool (read-only).
No parameter schema in public metadata yet.
shelly_rpc_writeGeneric engine tool for mutations, requires confirm:true and data-loss double-gate.
Generic engine tool for mutations, requires confirm:true and data-loss double-gate.
No parameter schema in public metadata yet.
shelly_system_rebootGated system tool.
Gated system tool.
No parameter schema in public metadata yet.
shelly_schedule_listGated schedule tool.
Gated schedule tool.
No parameter schema in public metadata yet.
shelly_scene_listScene tool for listing named multi-device routines.
Scene tool for listing named multi-device routines.
No parameter schema in public metadata yet.
shelly_scene_runScene tool for running a named routine.
Scene tool for running a named routine.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
shelly-mcp
mcp-name: io.github.Buggy1111/shelly-mcp
MCP server for the entire Shelly smart-home ecosystem — read, control, and automate Shelly devices of every generation (Gen1 → Gen4; BLU via its gateway or the generic RPC engine, dedicated BLU tools are on the roadmap) from any MCP client (Claude Desktop, Claude Code, Cursor, …). Local-first (zero rate-limit, ~10 ms, full API), with cloud fallback for off-LAN access.
⚠️ Unofficial community project. Not affiliated with, endorsed by, or sponsored by Allterco Robotics / Shelly. "Shelly" is a trademark of its respective owner.
🚧 Alpha / in development. See
docs/for the full design.
Why
The only existing Shelly MCP servers are cloud-only and minimal. shelly-mcp unifies Gen1 and Gen2+ behind one tool surface, covers energy monitoring and automation (schedules, scripts, webhooks, KVS), and auto-discovers any device's capabilities — including hardware released after this server was written.
Install
uvx shelly-mcp # or: pip install shelly-mcp
Register in your MCP client:
Details
- Repository
- github.com/buggy1111/shelly-mcp
- Website
- github.com/Buggy1111/shelly-mcp
- Category
- Automation & Workflows
- Package
shelly-mcp- Transport
- STDIO
- Registry
- MCP registry, active
More from buggy1111
Related Automation & Workflows MCP servers
View all
Mcp Serverceki-me/mcp-serverHire specialists by the hour — search, schedule, and pay via MCP protocol.0stars
Meta Ads Mcpco.pipeboard/meta-ads-mcpFacebook / Meta Ads automation with AI: analyze performance, test creatives, optimize spend.0stars
Dealboardcom.getdealboard/dealboardSimple deal tracker with pipeline cards, notes, goals, reports, and AI-powered deal updates.0stars
Hatchablecom.hatchable/hatchableBuild, deploy, and host full-stack web apps from any MCP client. DB, auth, storage, cron included.0stars
OmegaAIthe-lambda-group/query-omega-mcpQuery, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.0stars
Rocket Plus Mcpcrypto-goatz/rocket-plus-mcp56+ AI tools for CRM, content, workflows, SkillForge & marketing automation.0stars