Skip to content
Tresca
MCP serverCommunity

TiaMcp

by rickgaiserAGPL-3.0

Reads and writes TIA Portal V21 PLC blocks, tags and HMI content through Openness, exported as a folder of text files an agent can edit in small pieces.

InstallRepository Checked 19 Nov 2026

What it's for

TiaMcp drives a running copy of TIA Portal on Windows. Its documentation describes 5 capabilities and 5 limitations, summarised below.

What it can do

  • Exports project source to a folder tree on disk and writes changes back, with a dry-run option and only the changed items written.
  • Handles SCL, FBD, LAD, global DBs, UDTs and whole-block STL as text, PLC and HMI tag tables and HMI alarms as CSV, and S7-GRAPH as a compact text format.
  • Creates, deletes, renames and renumbers blocks, tags, UDTs, alarms and HMI screens, and compiles.
  • Reads and writes WinCC Unified screens as JSON and classic WinCC objects as XML.
  • Refuses to overwrite items that were changed in TIA Portal since they were read, unless forced.

Limitations

  • Hardware configuration is not supported.
  • New GRAPH blocks can only be cloned from an existing one, and parts of GRAPH blocks are read-only.
  • The README lists several actions that crash TIA Portal V21 and that the server avoids or refuses, and some .s7dcl imports that go wrong without an error.
  • Writes are slow, and an open HMI tag editor slows Openness calls about eightfold.
  • Your Windows user must be in the Openness user group; you build the server yourself with .NET.

AI-generated models, drawings and results must be checked by a qualified engineer before use.