Skip to main content
Glama
Disane87

weishaupt-wem-mcp-server

by Disane87

Weishaupt WEM Portal MCP Server

Control and monitor your Weishaupt heating system with AI assistants via the WEM Portal

Version npm License: MIT Blog Website

MCP TypeScript Node.js semantic-release

GitHub Stars GitHub Issues CI


Features

  • Device Discovery - List all devices and modules from your WEM Portal account

  • Live Parameters - Read temperatures, pressure, operating modes with current values

  • Full Overview - Get a complete snapshot of your entire heating system in one call

  • Write Parameters - Adjust target temperatures, operating modes, schedules

  • Device Status - Check connection status of your devices

  • Writable Filter - List only the parameters you can actually change

  • Session Management - Automatic cookie-based auth with login lock for concurrent requests


Related MCP server: victron-tcp

Quick Start

No installation needed. Configure your MCP client to run:

npx @disane-dev/weishaupt-wem-mcp-server

Install from source

git clone https://github.com/Disane87/weishaupt-wem-mcp-server.git
cd weishaupt-wem-mcp-server
npm install
npm run build

Configuration

Add to your Claude Desktop config:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weishaupt-wem": {
      "command": "npx",
      "args": ["-y", "@disane-dev/weishaupt-wem-mcp-server"],
      "env": {
        "WEM_USERNAME": "your_email@example.com",
        "WEM_PASSWORD": "your_password"
      }
    }
  }
}
claude mcp add weishaupt-wem -- npx -y @disane-dev/weishaupt-wem-mcp-server

Set the environment variables WEM_USERNAME and WEM_PASSWORD before starting.

{
  "mcpServers": {
    "weishaupt-wem": {
      "command": "node",
      "args": ["/path/to/wem-mcp/build/index.js"],
      "env": {
        "WEM_USERNAME": "your_email@example.com",
        "WEM_PASSWORD": "your_password"
      }
    }
  }
}

Environment Variables

Variable

Required

Description

WEM_USERNAME

Yes

Your WEM Portal email

WEM_PASSWORD

Yes

Your WEM Portal password

WEM_API_URL

No

API base URL (default: https://www.wemportal.com/app)


Available Tools

Tool

Description

wem_get_devices

List all devices with modules. Call this first to discover IDs.

wem_get_device_status

Get connection status of a device

wem_get_overview

Full device overview: all modules with all parameters in one call

wem_get_parameters

Get all parameters of a module with current values

wem_get_parameter_meta

Get parameter metadata (names, min/max, enums, writable flag)

wem_get_writable_parameters

List only adjustable parameters with ranges and options

wem_read_parameters

Read specific parameter values by ID

wem_write_parameter

Set a parameter value (e.g., target temperature)

TIP

Start withwem_get_devices to discover your deviceId, moduleIndex, and moduleType, then use wem_get_overview for a complete snapshot of your heating system.


Typical Workflow

1. wem_get_devices
   -> Returns devices with modules (WE0=heat generator, HZK0=heating circuit, WW0=hot water)

2. wem_get_overview (deviceId)
   -> Returns ALL modules with ALL parameters in one call

3. wem_get_writable_parameters (deviceId, moduleIndex, moduleType)
   -> Shows what you can adjust, with min/max ranges

4. wem_write_parameter (deviceId, moduleIndex, moduleType, parameterId, numericValue)
   -> Sets a writable parameter (e.g. target temperature)

Common Module Types

Type

Name

Description

1

SYSTEM

System overview

2

HZK

Heating circuit (temperatures, operating mode)

3

WW

Hot water (temperature, push, schedule)

5

TERMINAL

Control panel

6

GATEWAY

Communication gateway

7

WE

Heat generator (boiler/heat pump performance)

9

Device

Physical device unit

10

GROUND

Ground module


Development

Command

Description

npm run build

Build the project

npm run watch

Watch mode (auto-rebuild on changes)

npm start

Run server directly

npm test

Test API connection

npm run inspector

Official MCP Inspector (Web UI)

npm run inspector:cli -- devices

CLI inspector for quick API tests


Troubleshooting

NOTE

Make sure you can log in atwemportal.com before using this server.

Issue

Solution

Authentication failed

Verify credentials, check if WEM Portal blocks after too many attempts

Connection timeout

Check internet, WEM Portal may be temporarily unavailable (30s default timeout)

Parameter values show 0

Some parameters (e.g. room temperature) require a physical sensor connected to the device


Contributing

Contributions are welcome! Please open an issue or submit a pull request.


License

MIT - see LICENSE


disane.dev | Blog | GitHub | npm

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with Home Assistant smart home devices through natural language. Control devices, manage automations, query entity states, and retrieve historical data across your home automation system.
    1
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Connect AI assistants to Victron Energy systems to read real-time solar, battery, grid, and inverter data from your local network via Modbus TCP or MQTT.
    32
    25
    3
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables LLM applications to query and visualize data from Bosch/Buderus heat pumps via ems-ESP, including temperatures, statistics, and heat curves through natural language.
    9
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    An unofficial MCP (Model Context Protocol) server that exposes a Vaillant heat pump's data to AI assistants like Claude. Query outdoor and room temperatures, hot water status, energy consumption, COP estimates, schedules, and diagnostics through natural conversation.
    4
    MIT

View all related MCP servers

Related MCP Connectors

  • Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors β€” no code.

  • Unofficial integration! ## ✨ Key Features ### πŸ’° Financial Intelligence - **Smart Charging Cost An…

  • Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

View all MCP Connectors

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/Disane87/weishaupt-wem-mcp-server'

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