loxone-mcp-gen1
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
loxone-mcp-gen1 · v0.8
Loxone MCP for Miniserver Gen 1
An MCP server that lets an AI assistant (e.g. Claude) read, analyze and safely edit copies of Loxone Config project files (.Loxone) — including on a Miniserver Gen 1, which the official Loxone MCP does not support.
Unofficial. Not affiliated with or endorsed by Loxone Electronics GmbH. "Loxone" is a trademark of its owner. Use at your own risk.
Why
Most Loxone MCP servers can only control devices (switch lights, read states). This one works on the program: it understands pages, blocks, connections and placeholders, and can add and wire logic — always into a new file that you open in Loxone Config, check, and load into the Miniserver yourself. Loxone Config stays the final safety check.
Related MCP server: RemoteConnect MCP Server
Features
Area | Tools |
Read |
|
Catalog |
|
Edit logic |
|
Build plan |
|
Status with icons |
|
Peripherals |
|
Rooms/categories |
|
Working copy |
|
Miniserver (read only) |
|
Analysis & recipes |
|
Tool descriptions and messages are currently in German.
Requirements
Windows (icon search and recycle-bin cleanup use Windows paths/APIs; the core works elsewhere)
Python ≥ 3.11 and uv
Loxone Config installed (for the icon library) and your project files
Optional: Git (for
backup_miniserver)
Setup
Add to your MCP client configuration (example for Claude Desktop):
{
"mcpServers": {
"loxone-mcp-gen1": {
"command": "uv",
"args": ["run", "--directory", "C:\\path\\to\\loxone-mcp-gen1", "server.py"],
"env": {
"LOXONE_PROJECTS_DIR": "C:\\Users\\<you>\\Documents\\Loxone\\Loxone Config\\Projects",
"LOXONE_HOST": "http://<miniserver-ip>",
"LOXONE_USER": "<user>",
"LOXONE_PASS": "<password>"
}
}
}
}Then, in the assistant: run catalog_learn once (it learns the block types from your project files) and project_set_main with a pattern for your project, e.g. my_home_v*.Loxone.
Settings
What | How |
Project folder |
|
Main project |
|
Catalog file |
|
Miniserver access (read only) |
|
Icon library |
|
Backup folder |
|
Safe workflow
project_open— check theabgleichfield: does the file match the Miniserver?Edit (ideally with
build_plan), thenproject_validate/project_lint.project_save("my_home_v23.Loxone")— always a new file. The project timestamp is set to now; otherwise Config would treat the Miniserver program as newer when loading.Open the new file in Loxone Config, decline the "automatic backup" prompt, check it, load it into the Miniserver.
verify_load(cleanup=True)— confirms the Miniserver runs exactly this file.
Known pitfalls (learned the hard way)
Loxone Config silently drops invalid connections. Input placeholders must use output
AQ(digital memories:Q).Config replaces
<and%in block titles with_.Querying
/dev/sps/io/<name>/stateon a virtual text input overwrites its text with "state". The live tools never query text inputs.System variables are fed via an output placeholder of the system variable, not via the
sourceattribute.Pages have no size in the file; the visible sheet is about 23,400 × 16,300 units. New blocks are placed inside it.
After loading, a Gen 1 Miniserver is unreachable (HTTP 503) for about a minute.
Zehnder ComfoAir (RS232) sends a data byte
0x07as07 07, which shifts all following bytes for fixed-position RS232 sensors.
What it deliberately does not do
It never uploads to the Miniserver and never overwrites your files. Loading stays in Loxone Config.
It sends no switching commands. Live access is a fixed whitelist of read-only requests (plus an FTP download for backups).
Tests
uv run python test_smoke.py "C:\path\to\your\project.Loxone"License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Let your coding agent read your GameSalad projects, and edit them live in Creator on Pro and Edu.
Read and edit DAW projects as an agent, save native Logic projects, convert projects between DAWs
Open, inspect, filter, edit and convert xlsx and csv files from your AI chat. Processing is local.
Open, inspect, filter, edit and convert xlsx and csv files from your AI chat. Processing is local.
Related MCP Servers
- FlicenseAqualityCmaintenanceEnables AI agents to build and edit MIT App Inventor projects as .aia files, supporting screens, components, properties, blocks, assets, and project merging.10-
- AlicenseBqualityDmaintenanceEnables AI agents to discover, inspect, edit, rebuild, and save Schneider Electric RemoteConnect and SCADAPack x70 IEC logic projects, including program sections, hardware, variables, and Modbus configuration.631MIT
- FlicenseAqualityCmaintenanceLets AI agents and users analyze Mitsubishi MELSEC .gx3 projects directly, tracing coil conditions, checking device references, comparing program changes, and inspecting ladder logic without opening GX Works3.134-
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to read and edit RPG Maker VX Ace and VX project data files directly, including databases, maps, events, scripts, and validation, without requiring Ruby.3MIT