nickol-knx — Claude Code MCP server: KNX audit
Checks KNX/ETS projects and builds Home Assistant YAML. Useful when you need a read-only review of a .knxproj before deployment.
claude mcp add --env NICKOL_KNX_WORKSPACE=<NICKOL_KNX_WORKSPACE> --env NICKOL_KNX_CATALOG=<NICKOL_KNX_CATALOG> --transport stdio nickol-knx -- uvx nickol-knx-mcpWhat nickol-knx does
nickol-knx exposes KNX project work through an MCP server. It reads .knxproj files, checks naming, DPT and sub-DPT values, command/status links, KNX Secure, and Matter readiness. The server can suggest concrete fixes, assess project completeness, and compare two project versions.
It can also assemble Home Assistant entities for lights, climate, covers, and sensors from device state. A device library expands actuators into their communication objects, including vendor models parsed from ETS application programs. The server stays read-only and never connects to the live KNX bus. Running it uses uvx; the project lists Python 3.10+ as its Python requirement.
What it helps with
- audit a
.knxprojbefore ETS work - spot mismatched DPT and command/status links
- build Home Assistant YAML from project data
- diff two KNX project versions
- compose a new project from room templates
Example prompts for the agent
- Audit this
.knxprojfor naming, DPT, status links, and KNX Secure issues. - Generate Home Assistant entities from the device state in this project.
- Compose a new KNX project from room templates using the
basicandcomfortpresets, then show the allocation manifest.
How to install nickol-knx
Platform CLI
claude mcp add --env NICKOL_KNX_WORKSPACE=<NICKOL_KNX_WORKSPACE> --env NICKOL_KNX_CATALOG=<NICKOL_KNX_CATALOG> --transport stdio nickol-knx -- uvx nickol-knx-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nickol-knx-mcp <command>
Platform CLI
codex mcp add nickol-knx --env NICKOL_KNX_WORKSPACE=<NICKOL_KNX_WORKSPACE> --env NICKOL_KNX_CATALOG=<NICKOL_KNX_CATALOG> -- uvx nickol-knx-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nickol-knx-mcp <command>
Config file
{
"mcpServers": {
"nickol-knx": {
"command": "uvx",
"args": [
"nickol-knx-mcp"
],
"env": {
"NICKOL_KNX_WORKSPACE": "<NICKOL_KNX_WORKSPACE>",
"NICKOL_KNX_CATALOG": "<NICKOL_KNX_CATALOG>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nickol-knx-mcp <command>
Config file
{
"servers": {
"nickol-knx": {
"type": "stdio",
"command": "uvx",
"args": [
"nickol-knx-mcp"
],
"env": {
"NICKOL_KNX_WORKSPACE": "<NICKOL_KNX_WORKSPACE>",
"NICKOL_KNX_CATALOG": "<NICKOL_KNX_CATALOG>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nickol-knx-mcp <command>
Platform CLI
gemini mcp add -e NICKOL_KNX_WORKSPACE=<NICKOL_KNX_WORKSPACE> -e NICKOL_KNX_CATALOG=<NICKOL_KNX_CATALOG> nickol-knx uvx nickol-knx-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from nickol-knx-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about nickol-knx
How do I install nickol-knx in Claude Code?
Run claude mcp add nickol-knx-mcp -- uvx nickol-knx-mcp. This registers the MCP server with Claude Code.
What does nickol-knx do?
It audits KNX/ETS projects, suggests repairs, compares project versions, and generates Home Assistant YAML. It can also compose new projects from room templates.
Does nickol-knx connect to a live KNX bus?
No. It is a read-only design-time server for project files and does not connect to the live KNX bus.
