Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HUB1 | No | Password for the first Plugwise hub (8-character code from gateway sticker) | |
| HUB2 | No | Password for the second Plugwise hub (8-character code from gateway sticker) | |
| HUB1IP | No | Optional: IP address of the first Plugwise hub for faster discovery and auto-loading | |
| HUB2IP | No | Optional: IP address of the second Plugwise hub for faster discovery and auto-loading | |
| PLUGWISE_HOST | No | IP address of the Plugwise gateway | |
| PLUGWISE_PASSWORD | No | Password for the Plugwise gateway |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |