Shelly Mcp Server

Name: Shelly Mcp Server
Author: grische

by grische

MCP server for Shelly Plug

3 tools GitHub

No known CVEs

AGPL-3.0 license

Actively maintained

Last commit 22d ago

Works with most clients

Transport: stdio

3 tools · ~214 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

Other

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shelly-mcp-server": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/shelly-mcp-server)](https://mcppedia.org/s/shelly-mcp-server)

Read me

What Shelly Mcp Server does

A standalone MCP stdio server that wraps the Shelly Plus Plug S Gen2 RPC API. It exposes three tools (switch_set, switch_status, plug_info) for controlling the relay and reading telemetry, and manages the plug's status LED as a startup/shutdown side effect — the LED switches to a dim blue/red preset while the server is attached and restores the user's original config on exit.

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

72/100across 5 weighted dimensions

How we score →

0255075100

−28

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (3)

Click any tool to inspect its schema.

~214 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Shelly Mcp Server safe to use?: Shelly Mcp Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under AGPL-3.0.
How do I install Shelly Mcp Server?: Shelly Mcp Server can be installed by cloning its GitHub repository and following the setup instructions in the README.
What can Shelly Mcp Server do?: Shelly Mcp Server provides 3 tools: switch_set, switch_status, plug_info. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Shelly Mcp Server?: Shelly Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is Shelly Mcp Server actively maintained?: Shelly Mcp Server is actively maintained — last commit was 22 days ago.

Similar servers

Others in other

View all →

io.github.wyre-technology/spanning-mcp90

MCP server for Spanning Cloud Backup — M365/GWS/Salesforce backups, restores, audit.

io.github.codeofaxel/kiln88

AI agent control of 3D printers — 432 tools for OctoPrint, Moonraker, Bambu, Prusa, Elegoo

18 11

io.github.wyre-technology/autotask-mcp88

MCP server for Kaseya Autotask PSA — companies, tickets, projects, time entries, and more.

36 6

io.github.AnchorRegistry/ar-mcp88

On-chain provenance lookup for AnchorRegistry. Resolve AR-IDs, hashes, and full trees. Authless.

MCP Security Weekly

Get CVE alerts and security updates for Shelly Mcp Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

shelly-mcp-server

A standalone MCP stdio server that wraps the Shelly Plus Plug S Gen2 RPC API. It exposes three tools (switch_set, switch_status, plug_info) for controlling the relay and reading telemetry, and manages the plug's status LED as a startup/shutdown side effect — the LED switches to a dim blue/red preset while the server is attached and restores the user's original config on exit.

Environment variables

All variables are read once at startup. Invalid values exit 1 with a stderr message naming the offending variable; there are no silent defaults for malformed input.

Variable	Default	Description
`SHELLY_HOST`	required	Plug IPv4 address or hostname. No URL scheme, no path. IPv6 must be bracketed (`[::1]`). Leading/trailing whitespace trimmed; values containing `/` or `://` are rejected.
`SHELLY_TIMEOUT_MS`	`5000`	Per-RPC timeout in milliseconds. Must parse as a positive integer.
`SHELLY_LED_AUTO_MANAGE`	`true`	Strict parse: only the literals `true` or `false` (case-sensitive) are accepted. When `true`, paint the MCP LED preset at startup and restore the original config at shutdown.
`SHELLY_AUTO_OFF_ON_SHUTDOWN`	`true`	Same strict parse rule. When `true`, the relay is turned off during graceful shutdown. Set to `false` if the plug powers something you do not want killed on server restart.

Variable

Default

Description

SHELLY_HOST

required

Plug IPv4 address or hostname. No URL scheme, no path. IPv6 must be bracketed ([::1]). Leading/trailing whitespace trimmed; values containing / or :// are rejected.

SHELLY_TIMEOUT_MS

5000

Per-RPC timeout in milliseconds. Must parse as a positive integer.

SHELLY_LED_AUTO_MANAGE

true

Strict parse: only the literals true or false (case-sensitive) are accepted. When true, paint the MCP LED preset at startup and restore the original config at shutdown.

SHELLY_AUTO_OFF_ON_SHUTDOWN

true

Same strict parse rule. When true, the relay is turned off during graceful shutdown. Set to false if the plug powers something you do not want killed on server restart.

Stop-grace caveat. Shutdown runs the LED restore and the optional auto-off in parallel, bounded by SHELLY_TIMEOUT_MS. If you raise SHELLY_TIMEOUT_MS above 8000, configure your container runtime's stop grace period to SHELLY_TIMEOUT_MS + 2s (e.g. docker run --stop-timeout 12 …) or the LED restore can be SIGKILLed mid-RPC and leave the plug on the MCP preset.

Tools

switch_set — Change the plug's relay state on or off. Returns the prior state, the resulting state, and live power telemetry. Parameters: state ("on" or "off").

switch_status — Read the current relay state and live power telemetry without changing anything. Use this when you need to know whether the plug is on, its power draw, voltage, current, or temperature. No parameters.

plug_info — Return identifying metadata for the Shelly plug: name, model, generation, firmware version. No parameters.

Frequently Asked Questions

Is Shelly Mcp Server safe to use?

Shelly Mcp Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under AGPL-3.0.

How do I install Shelly Mcp Server?

Shelly Mcp Server can be installed by cloning its GitHub repository and following the setup instructions in the README.

What can Shelly Mcp Server do?

Shelly Mcp Server provides 3 tools: switch_set, switch_status, plug_info. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Shelly Mcp Server?

Shelly Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is Shelly Mcp Server actively maintained?

Shelly Mcp Server is actively maintained — last commit was 22 days ago.

shelly-mcp-server

Environment variables

All variables are read once at startup. Invalid values exit 1 with a stderr message naming the offending variable; there are no silent defaults for malformed input.

Variable	Default	Description
`SHELLY_HOST`	required	Plug IPv4 address or hostname. No URL scheme, no path. IPv6 must be bracketed (`[::1]`). Leading/trailing whitespace trimmed; values containing `/` or `://` are rejected.
`SHELLY_TIMEOUT_MS`	`5000`	Per-RPC timeout in milliseconds. Must parse as a positive integer.
`SHELLY_LED_AUTO_MANAGE`	`true`	Strict parse: only the literals `true` or `false` (case-sensitive) are accepted. When `true`, paint the MCP LED preset at startup and restore the original config at shutdown.
`SHELLY_AUTO_OFF_ON_SHUTDOWN`	`true`	Same strict parse rule. When `true`, the relay is turned off during graceful shutdown. Set to `false` if the plug powers something you do not want killed on server restart.

Variable

Default

Description

SHELLY_HOST

required

Plug IPv4 address or hostname. No URL scheme, no path. IPv6 must be bracketed ([::1]). Leading/trailing whitespace trimmed; values containing / or :// are rejected.

SHELLY_TIMEOUT_MS

5000

Per-RPC timeout in milliseconds. Must parse as a positive integer.

SHELLY_LED_AUTO_MANAGE

true

Strict parse: only the literals true or false (case-sensitive) are accepted. When true, paint the MCP LED preset at startup and restore the original config at shutdown.

SHELLY_AUTO_OFF_ON_SHUTDOWN

true

Same strict parse rule. When true, the relay is turned off during graceful shutdown. Set to false if the plug powers something you do not want killed on server restart.

Tools

switch_set — Change the plug's relay state on or off. Returns the prior state, the resulting state, and live power telemetry. Parameters: state ("on" or "off").

plug_info — Return identifying metadata for the Shelly plug: name, model, generation, firmware version. No parameters.

Shelly Mcp Server

Install in your client

What Shelly Mcp Server does

Test This Server

Why this score

72/100across 5 weighted dimensions

Security

Tools (3)

Reviews

Frequently Asked Questions

Similar servers

Discussion

Shelly Mcp Server

Install in your client

What Shelly Mcp Server does

Test This Server

shelly-mcp-server

Build

Register with an MCP client

Environment variables

Tools

Development

License and trademark

Why this score

72/100across 5 weighted dimensions

Security

Tools (3)

Reviews

Frequently Asked Questions

Similar servers

Discussion

shelly-mcp-server

Build

Register with an MCP client

Environment variables

Tools

Development

License and trademark