Tiaopen Mcp

TiaOpen MCP

Build, inspect, organize, and import Siemens TIA Portal PLC content from any MCP-aware AI client.

---

What it does

An MCP server that wraps Siemens TIA Portal Openness so an AI assistant can work directly against an open TIA Portal project: list blocks and PLC data types, inspect XML, import raw XML or plain SCL, compile the PLC software, manage tag tables, create DBs, organize block and type groups, and generate LAD blocks from structured JSON.

Unofficial. Not affiliated with Siemens.

Prerequisites

| Software | Version | | --- | --- | | Windows | 10 or 11 | | TIA Portal | V20 Update 4 with an open project in the UI | | Node.js | 18 or newer | | MCP client | VS Code + Copilot, Cursor, Claude Desktop, or another MCP-aware client | | PowerShell | Windows PowerShell 5.1 or newer |

Install

git clone https://github.com/eponce00/tiaopen-mcp.git
cd tiaopen-mcp
npm install

Manual registration

If you want to register it yourself instead of relying on workspace config, point your MCP client at src/index.js.

VS Code (global):

code --add-mcp '{"name":"tiaopen","type":"stdio","command":"node","args":["C:/path/to/tiaopen-mcp/src/index.js"]}'

Cursor (global) add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tiaopen": {
      "command": "node",
      "args": ["C:/path/to/tiaopen-mcp/src/index.js"]
    }
  }
}

This repo also includes a ready-to-use .vscode/mcp.json entry for workspace-local use.

Restart the MCP client after changes under src/.

Project selection

This server talks to an already-open TIA Portal UI session. Most scripts attach to the first UI process whose window title matches Testing_Playground, then fall back to the first open project in that session.

If your project name is different, use the project_match or ProjectMatch parameter where supported.

How it works

The Node MCP server exposes typed tool schemas with Zod and dispatches each tool to a PowerShell script in scripts/.

• TIA Portal must already be running with the target project open.
• XML import and export flows are done through TIA Openness.
• SCL import goes through ExternalSource generation, then optional compile.
• Most mutating tools append a compile or save nudge when the operation succeeds.
• preflight_scl catches the two failure modes that waste the most time in TIA import flows: non-ASCII text and reserved-keyword identifier collisions.

Tools

| Tool | What it does | | --- | --- | | list_blocks | List all PLC blocks recursively, including type, language, number, consistency, and group path. | | list_data_types | List PLC data types recursively, including consistency and group path. | | list_tag_tables | List PLC tag tables and tag-table groups, including the default tag table. | | tia_status | Report TIA Portal process health, attachability, window titles, and open projects. | | save_project | Save the currently open TIA project to disk. | | list_groups | List both Program Blocks groups and PLC data type groups. | | ensure_library_layout | Apply or dry-run a manifest-driven group layout for blocks and PLC data types. | | get_block_xml | Export a PLC block as raw TIA XML. | | write_block | Import a raw XML block file into TIA and optionally compile it. | | write_scl_block | Import a plain .scl file as an external source, generate block(s), optionally compile, and optionally place them into groups. | | preflight_scl | Run static checks on an SCL file before import. | | create_group | Create a Program Blocks group path, including missing parents. | | create_type_group | Create a PLC data types group path, including missing parents. | | move_block_to_group | Move an existing block into a Program Blocks group. | | move_type_to_group | Move an existing PLC data type into a PLC data types group. | | compile | Compile the PLC software and return error and warning messages. | | list_tags | List PLC tags across the default and user-defined tag tables. | | create_tag | Add a tag to the default or a named tag table. | | list_templates | List available XML templates with purpose and token placeholders. | | create_block | Render a verified XML template, import it, and compile it. | | build_lad_block | Generate and import a LAD FC, FB, or OB from a structured JSON flow description. | | delete_item | Delete a named PLC block or PLC data type. | | preview_block | Render a template to XML without importing it into TIA. | | get_template_xml | Return the raw unresolved XML for a template. | | create_tag_table | Create a user-defined PLC tag table. | | create_global_db | Create a new empty global DB. | | create_instance_db | Create an instance DB for a user-defined FB. | | lookup_instruction | Search the bundled TIA V20 instruction reference. |

Example prompts

List all PLC blocks in the open TIA project
Show me the XML for FB_KistlerNC
Preflight this SCL file before import
Import UDT_KistlerNC_Cmd.scl into the Kistler NC type group
Create a Program Blocks group called Kistler NC/Helpers
Move FB_KistlerNC into Kistler NC
Create a LAD block that turns on %Q0.0 when %I0.0 is true
Compile the PLC software and show me the errors
Add a Bool tag called StartButton at %I0.0
Find the TIA documentation entry for TON

Troubleshooting

Server does not start. In VS Code, run MCP: List Servers, then start and trust the server. In Cursor, enable the MCP server in settings.

No TIA process matching the project was found. Open the project in the TIA Portal UI first, or pass a project_match value that matches the window title or project name.

SCL import fails with strange identifier or tag-definition errors. Run preflight_scl first. This repo intentionally blocks or warns on reserved identifiers and non-ASCII text because TIA Openness reports those failures poorly.

XML import fails silently or compiles with schema-style errors. Compare against get_template_xml or get_block_xml output from a known-good block. Namespace mismatches, unsupported XML comments inside network object lists, and wrong address encoding are common causes.

Changes worked in memory but are not on disk. Call save_project after successful mutations. TIA keeps edits in the live UI session until the project is saved.

License

MIT. See LICENSE.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: eponce00
• Source: eponce00/tiaopen-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.