Skip to main content
Glama
Loxone Miniserver MCP

Loxone Miniserver MCP

loxone-mcp

CI npm version npm downloads Glama License: MIT

An MCP (Model Context Protocol) server that connects AI assistants to a Loxone Miniserver smart home system.

Lets Claude (or any MCP-compatible AI) list rooms, query live sensor/actuator states, search devices, and send commands.

Features

  • list_rooms — all rooms with their controls

  • list_controls — all controls (name, type, UUID, room)

  • find_control — keyword search across name/room/type

  • get_status — live sensor and actuator values (optional room filter)

  • control_device — send commands (On/Off, dimmer %, blinds, HVAC, audio)

Related MCP server: Loxone MCP Server

Requirements

  • Loxone Miniserver with Cloud Connect enabled

  • Node.js 20+ (or Docker)

Installation

npm

npm install -g @syntropic/loxone-mcp

Then run with environment variables set:

LOXONE_SERIAL=XXXXXXXXXXXX \
LOXONE_USER=admin \
LOXONE_PASS=yourpass \
MCP_API_KEY=$(openssl rand -hex 32) \
loxone-mcp

From source

git clone https://github.com/syntropicsignal-ai/loxone-mcp.git
cd loxone-mcp
cp .env.example .env
# edit .env with your Miniserver serial, credentials, and a random API key
npm install
npm run build
npm start

The server listens on http://localhost:3000. The MCP endpoint is POST /mcp.

Docker

docker build -t loxone-mcp .
docker run -p 3000:3000 --env-file .env loxone-mcp

Configuration

Variable

Required

Description

LOXONE_SERIAL

Yes

12-char Miniserver serial (from Loxone Config → Miniserver)

LOXONE_USER

Yes

Miniserver username

LOXONE_PASS

Yes

Miniserver password

MCP_API_KEY

Yes

Bearer token for MCP endpoint auth (openssl rand -hex 32)

PORT

No

HTTP port (default: 3000)

Connecting to Claude

Add to your Claude MCP configuration:

{
  "mcpServers": {
    "loxone": {
      "url": "https://your-server/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Supported commands by device type

Type

Commands

Switch / Light

On, Off, pulse

Dimmer

On, Off, value/50 (0–100%), Up, Down

Jalousie (blinds)

Up, Down, Stop, FullUp, FullDown, shade

Gate

Open, Close, Stop

HVAC (IRoomControllerV2)

setComfortTemperature/21.5, override/1/22/3600

AudioZone

play, pause, stop, volume/50

Architecture

  • Stateless HTTP server — each POST /mcp creates a fresh transport (no session state)

  • Loxone Cloud Connect: resolves current tunnel URL via dns.loxonecloud.com on every request

  • Structure cache: Loxone app structure (LoxAPP3.json) cached for 60 seconds

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables natural language control of Loxone smart home systems, including lighting, audio, climate, and environmental monitoring, through MCP-compatible clients.
      41 npm
      3
      AGPL 3.0
    • 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