Skip to main content
Glama
Tommertom

Plugwise MCP Server

by Tommertom

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HUB1NoPassword for the first Plugwise hub (8-character code from gateway sticker)
HUB2NoPassword for the second Plugwise hub (8-character code from gateway sticker)
HUB1IPNoOptional: IP address of the first Plugwise hub for faster discovery and auto-loading
HUB2IPNoOptional: IP address of the second Plugwise hub for faster discovery and auto-loading
PLUGWISE_HOSTNoIP address of the Plugwise gateway
PLUGWISE_PASSWORDNoPassword for the Plugwise gateway

Tools

Functions exposed to the LLM to take actions

NameDescription
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.

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.

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.

set_preset

Set the preset mode on a thermostat or zone (e.g., home, away, sleep, vacation). Presets apply predefined temperature settings and behaviors configured in your Plugwise system.

get_temperature

Get current room temperature and setpoint for a specific thermostat or zone. Returns both the measured temperature and the target setpoint.

get_all_temperatures

Get current temperatures and setpoints for all thermostats and zones in the system. Returns comprehensive temperature data including measured values, setpoints, control states, and climate modes for every temperature-capable device.

get_temperature_offset

Get the temperature offset (calibration) for a thermostat device. The offset is used to calibrate the temperature sensor if it reads incorrectly. Returns the current offset value and its valid range.

set_temperature_offset

Set the temperature offset (calibration) for a thermostat device. This adjusts the measured temperature by a fixed offset.

control_switch

Turn a switch or relay on or off. Works with Plugwise switches, relays, and smart plugs. Use this to control any switchable device in your Plugwise network.

set_gateway_mode

Set the gateway mode (home, away, vacation). This is a system-wide setting that affects all zones and presets. Home mode uses normal schedules, away mode uses reduced temperatures, and vacation mode provides minimal heating/cooling.

set_dhw_mode

Set the domestic hot water (DHW) heating mode for systems with hot water control. Auto mode follows the schedule, boost mode provides immediate hot water heating, comfort mode maintains higher temperature, and off mode disables DHW heating.

set_regulation_mode

Set the heating regulation mode. Controls the overall heating system behavior. Use "heating" for normal operation, "off" to disable heating, or bleeding modes for system maintenance.

delete_notification

Delete all gateway notifications. Use this to clear error messages or warnings from the Plugwise gateway.

reboot_gateway

Reboot the Plugwise gateway. Use with caution as this will temporarily disconnect all devices and interrupt heating/cooling control. The gateway typically takes 1-2 minutes to fully restart.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Tommertom/plugwise-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server