TiaMcp
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.
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.
Install
dotnet build TiaMcp.slnCopy .mcp.json.example to .mcp.json and set "command" to the built or extracted TiaMcp.Host.exe.Source: github.com/rickgaiser/TiaMcp#registering-with-claude-code
MCP servers and skills run code on your computer. Review the source before installing.
Want your AI assistant to walk you through it? Copy a prompt for Claude or another assistant that asks it to check your setup and get your approval before each step.
Details
- Type
- MCP server
- Works with
- TIA Portal
- How it connects
- Drives a running copy of the tool
- Access
- Can modify models Questions to ask first
- Tool versions
- TIA Portal V21 and later
- Operating systems
- Windows
- Licence needed
- Yes, a licence for TIA Portal
- Transport
- Local (stdio)
- AI clients documented
- Claude Code What this means
- Licence
- AGPL-3.0
- Language
- C#
Compared with other TIA Portal integrations
| Name | Type | Origin | How it connects | Licence | Stars | Updated |
|---|---|---|---|---|---|---|
| TIA Portal MCP server (TiaMcpServer) | MCP server | Community | Drives a running copy of the tool | MIT | 139 | 2 days ago |
| TIA-Portal MCP-Server (heilingbrunner) | MCP server | Community | Drives a running copy of the tool | MIT | 142 | 3 days ago |
| Siemens Docs MCP | MCP server | Community | Documentation only; doesn't operate the tool | MIT | 3 | 5 days ago |
| totally-integrated-claude | Plugin | Community | Documentation only; doesn't operate the tool | MIT | 93 | 5 weeks ago |
| PLCMCP (TIA Portal MCP Server) | MCP server | Community | Drives a running copy of the tool | MIT | — | — |
| T-IA Connect | MCP server | Commercial · Paid | Drives a running copy of the tool | proprietary | — | — |
| TIA Portal Openness MCP (asckye) | MCP server | Community | Drives a running copy of the tool | MIT | — | — |
| TiaLink | MCP server | Commercial · Paid | Drives a running copy of the tool | Proprietary gateway; MIT stdio bridge; CC-BY-4.0 docs | — | — |
| TiaMcp | MCP server | Community | Drives a running copy of the tool | AGPL-3.0 | — | — |
Facts from each project's documentation; stars and update dates from GitHub. Nothing here is ranked.
Sources
Checked 19 Nov 2026
Something wrong? Suggest an edit