Plugwise

You run a TypeScript-based MCP server that automatically discovers Plugwise hubs on your network, exposes a programmable API, and supports multiple gateways. It lets you control thermostats, switches, and plugs, read energy data, and use an AI agent or JSON-RPC for scripting and automation.

How to use

Install and run the server to connect your Plugwise hubs, then use your MCP client to perform actions. You can operate through direct device controls, read current states, set temperatures and presets, monitor energy usage, and manage multiple gateways simultaneously. If you prefer natural language interactions, use the AI agent mode to issue commands in plain language and have the system translate them into device actions.

How to install

# Prerequisites
- Node.js 17 or higher
- npm or yarn
- Plugwise gateway (Adam, Anna, Smile P1, or Stretch)

# Install globally for convenient access
npm install -g plugwise-mcp-server

# Or run directly without installation
npx plugwise-mcp-server

If you are building from source, clone the project, install dependencies, and build before running the server.

git clone https://github.com/Tommertom/plugwise-mcp-server.git
cd plugwise-mcp-server
npm install
npm run build

Additional content

Configuration and usage details below show how to connect to hubs, manage devices, and run the server in different modes. You can run the standard MCP server for direct tool access or use the AI Agent mode for natural language control. Environment variables provide credentials and optional hub IPs to speed up discovery.

Security and testing notes

Store hub passwords securely in environment variables or a .env file. Limit access to the local network and consider VPN or isolated VLAN for IoT devices. Credentials are passed to the server process through secure channels within the MCP configuration.

Tools and actions you can perform

Connect to a hub, retrieve device data, adjust climate settings, manage gateways, and monitor energy usage. The server exposes a set of tools you can call via MCP to perform these actions.

Example workflows

Connect to a hub and list devices, then set a temperature or a preset on a location, and finally read energy usage for monitoring.

Available tools

connect

Connect to a Plugwise gateway, optionally using a specific host and password.

get_devices

Retrieve all devices, zones, sensors, and their current values.

set_temperature

Set the thermostat temperature setpoint for a given location.

set_preset

Change thermostat preset mode (e.g., home, away, sleep, vacation).

control_switch

Turn switches or plugs on or off.

set_gateway_mode

Set the gateway mode (home, away, vacation).

set_dhw_mode

Set domestic hot water mode (auto, boost, comfort, off).

set_regulation_mode

Set heating regulation mode.

delete_notification

Clear gateway notifications.

reboot_gateway

Reboot the gateway (use with caution).

plugwise://devices

Access current state data for all devices as a resource.

setup_guide

Provide comprehensive setup instructions.