Plugwise MCP Server

MCPOpen SourceMIT14.2

by Tommertom • IoT & Embedded

A TypeScript MCP server that automatically discovers Plugwise gateways and exposes device control and monitoring over the Model Context Protocol for integration with MCP clients.

Example Use Cases

1
Discover Plugwise gateways on a local network and automatically load hub credentials for connection and device enumeration.
2
Read and monitor device states, sensor measurements, and energy usage across one or more Plugwise hubs in real time.
3
Control thermostats, set temperature setpoints/presets, and toggle smart plugs via MCP-compatible clients (stdio or HTTP).

Description

A TypeScript-based MCP server that discovers Plugwise hubs on the local network, securely manages hub credentials, and exposes devices (thermostats, plugs, sensors) and energy metrics via MCP tools and resources. It supports multi-hub management, real-time updates, mock mode for safe testing, and integrates with MCP clients over stdio or HTTP. The project is open-source (MIT) and designed for local network use with detailed documentation and test scripts.

Capabilities(16 total)

Tools (16)

add_hub

Add a new Plugwise hub by providing its name (used as password). Scans the network to find the hub and stores it in the /hubs folder as a JSON file for future use. The hub name is the unique identifier printed on the back of your Plugwise device.

hubName:string*

list_hubs

List all registered Plugwise hubs from the /hubs folder and in-memory registry. Returns hub information including name, IP address, model, and firmware version for each discovered hub.

connect

Connect to a Plugwise gateway (Adam, Anna, Smile P1, or Stretch) and retrieve gateway information. If no host is provided, automatically connects to the first discovered hub. Returns detailed gateway information including model, type, version, hostname, and MAC address.

host:stringpassword:stringport:numberusername:string

get_devices

Retrieve all Plugwise devices and their current states, sensors, and capabilities. Returns comprehensive information for all connected devices including thermostats, switches, sensors, and other appliances. Includes current readings, capabilities, and operational states.

set_temperature

Set the temperature setpoint on a thermostat or zone. Supports single setpoint for heating/cooling systems, or separate low/high setpoints for heat pump systems. Changes take effect immediately.

location_id:string*setpoint:numbersetpoint_low:numbersetpoint_high:number

Quick Actions

View on GitHub

Security

Scanned 2 month(s) ago

Risk Level

MINIMAL

Read-only data retrieval, no side effects

Trust Score

C57/100

6/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities16 Tools / 0 Prompts / 0 Resources

OwnerTommertom

CategoryIoT & Embedded

DependenciesStandalone

Set Your Username