Skip to content

giogdev/shelly-integrations

Repository files navigation

Shelly integration (MCP + REST API)

.NET 10 integration project that connects AI assistants and external systems to your Shelly Cloud devices.

Docker Image Size (MCP) Docker Pulls (MCP)

Docker Image Size (API) Docker Pulls

The project provides two independent components:

  • MCP Server — exposes Shelly devices as tools for AI assistants via the Model Context Protocol
  • REST API Gateway — exposes Shelly devices over HTTP for dashboards, home automation platforms, and any REST-capable client

alt text


Contest winner

🏆 1st place in the "Crafter" category at the Shelly Smart Home Challenge 2025 🏆


Usage example

  • I'm using this project (api) as tool used by AI agents, with purpose to get historical/real time data from Shelly weather station
  • Control shelly device from AI Agents (like n8n or OpenClaw 🦞)
  • Get information about weather history

Documentation

  • MCP Server — configuration, Docker setup, Claude Desktop and Claude Code integration
  • REST API Gateway — available endpoints, Docker setup, how to enable or disable the service

Changelog

v2.0.0

  • New api project
  • New methods to get historical and statistics data (API+MCP)
  • New methods to get power consumption data (API+MCP)
  • Bug & fix

v1.0.0

  • MCP server
  • Light and device control (switch, get states)

About

Rest API & MCP Server to integrate anything with Shelly Cloud

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages