Log inSubmit server
Plugwise MCP logo

Plugwise MCP

by Tommertom

Control Plugwise gateways, thermostats, switches, smart plugs, and climate settings through MCP over the local network.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install Plugwise MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tommertom-plugwise-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "plugwise-mcp-server"
      ],
      "env": {
        "HUB1": "YOUR_VALUE_HERE",
        "HUB1IP": "YOUR_VALUE_HERE",
        "HUB2": "YOUR_VALUE_HERE",
        "HUB2IP": "YOUR_VALUE_HERE",
        "OPENAI_API_KEY": "YOUR_VALUE_HERE",
        "PLUGWISE_AGENT_MODEL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Tommertom/plugwise-mcp MCP server connects MCP clients to Plugwise gateways on a local network, with automatic hub discovery and support for Adam, Anna, Smile P1, and Stretch models. It exposes tools for registering hubs, reading device state and temperatures, changing thermostat settings, operating switches, and managing gateway modes. The TypeScript server runs over standard input/output and reads hub credentials from environment variables or its stored hub registry. Reach for it when an agent needs to monitor or control Plugwise heating, climate, switching, or gateway functions.

Use cases

  • Discover Plugwise hubs on a local network
  • Monitor temperatures, setpoints, and device states
  • Adjust thermostat presets and temperature offsets
  • Switch smart plugs, relays, and other appliances
  • Manage gateway, hot-water, and heating modes

Key features

  • Automatic Plugwise hub discovery
  • Multi-hub registration and management
  • Thermostat and temperature control
  • Switch and smart-plug operation
  • Gateway and heating-mode management
  • Device-state and sensor monitoring

Tools16

What Plugwise MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

8/9 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · plugwise-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads95Package downloads in the last 30 days.
Last commit11mo agoMost recent push to the default branch.
Tools exposed16Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Plugwise MCP works

What Tommertom/plugwise-mcp MCP server does

Tommertom/plugwise-mcp MCP server gives an MCP client access to Plugwise gateways and the devices connected to them. It supports Adam, Anna, Smile P1, and Stretch gateways and can manage more than one hub. The server can discover hubs on the local network, save discovered hub details in a /hubs folder, and reuse those registrations later.

Its device coverage includes thermostats, zones, switches, relays, smart plugs, sensors, and other appliances exposed by the Plugwise system. Read operations return gateway information, device states, sensor readings, capabilities, temperatures, setpoints, control states, and climate modes. A plugwise://devices resource provides the current state of all devices, and a setup_guide prompt provides setup instructions.

How it works

The server communicates with Plugwise hardware through the local network. add_hub scans for a hub using the supplied name, which is the unique identifier printed on the device and is also used as its password. Registered hubs can be inspected with list_hubs, which reports details such as name, IP address, model, and firmware version.

connect opens a gateway connection and returns identifying information including its model, type, version, hostname, and MAC address. When no host is provided, it connects to the first discovered hub. The standard server exposes more than 15 specialized tools. An alternate agent mode provides a natural-language interface through a single tool, while JSON-RPC mode supports scripted requests.

Setup and configuration

Tommertom/plugwise-mcp MCP server requires Node.js 17 or newer and npm or yarn, plus a supported Plugwise gateway. Install it globally with npm install -g plugwise-mcp-server, run it directly with npx plugwise-mcp-server, or build it from source with npm install followed by npm run build.

Provide hub credentials through the MCP client's env configuration or a .env file. HUB1, HUB2, and similar variables hold the eight-character hub codes; matching variables such as HUB1IP and HUB2IP can provide known addresses for faster discovery and loading. The README includes stdio configurations for Claude Desktop, Cline, Cursor, Visual Studio Code Copilot, and Windsurf Editor.

The server can also run in mock mode for read-only and feature tests without physical hardware. Agent mode can use OPENAI_API_KEY and PLUGWISE_AGENT_MODEL when configured with the natural-language agent.

Tools and capabilities

  • Discover and register hubs with add_hub, then list them with list_hubs.
  • Connect to a selected gateway and retrieve gateway metadata.
  • Read all devices, current states, sensors, capabilities, and measurements.
  • Read one temperature or all temperatures and their setpoints.
  • Set thermostat temperature setpoints, including separate low and high values for heat-pump systems.
  • Change thermostat presets such as home, away, sleep, and vacation.
  • Read or adjust thermostat temperature calibration offsets.
  • Turn Plugwise switches, relays, and smart plugs on or off.
  • Set gateway modes, domestic hot water modes, and heating regulation modes.
  • Clear active gateway notifications or reboot a gateway.

Limitations and notes

The server controls devices through the local Plugwise network, so the relevant gateway must be reachable and its credentials must be available. Gateway reboots interrupt monitoring and control for approximately one to two minutes and should be reserved for troubleshooting.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Plugwise MCP

Tommertom/plugwise-mcp is an MCP server that connects AI clients to Plugwise gateways over the local network. Its main tools discover hubs, inspect devices, read temperatures, change thermostat settings, control switches, and manage gateway modes, notifications, and reboots. It supports Adam, Anna, Smile P1, and Stretch gateways.

Install it with `npm install -g plugwise-mcp-server` or run it without installation using `npx plugwise-mcp-server`. Source installation uses `npm install`, `npm run build`, and then `npm start`. Node.js 17 or newer is required.

Yes, Tommertom/plugwise-mcp works with Cursor through its standard input/output MCP configuration. Add the server to `.cursor/mcp.json` for a project or `~/.cursor/mcp.json` for all projects, using `npx` and the required hub environment variables.

It supports Plugwise Adam, Anna, Smile P1, and Stretch gateways. The `connect` tool returns gateway details such as model, type, version, hostname, and MAC address after connecting.

Related MCP servers

All in Home Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPlugwise MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tommertom-plugwise-mcp?style=directory)](https://allmcps.com/mcp/tommertom-plugwise-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/tommertom-plugwise-mcp"><img src="https://allmcps.com/api/badge/tommertom-plugwise-mcp?style=directory" alt="Plugwise MCP on AllMCPs" /></a>