Skip to content
Public betaTalk2Tia v0.9 is in public beta: use it on test projects and expect rough edges.Send feedback →
Documentation

Getting started

Requirements, installation, MCP client configuration and how code editing works.

Public beta (v0.9). Talk2Tia is feature-complete but still in beta: use it on test projects, review every change before saving or downloading, and please report issues on GitHub.

Talk2Tia is an MCP server that lets an AI assistant (Claude Code, Claude Desktop or any MCP client) work inside Siemens TIA Portal V21 through the official Openness API.

Requirements

Run talk2tia --doctor to check the environment.

Build from source

dotnet build -c Release
dotnet test

The Siemens assemblies are referenced from the TIA Portal installation (C:\Program Files\Siemens\Automation\Portal V21\PublicAPI\V21\net48) and are never copied or committed. Override the location with dotnet build /p:TiaPublicApiDir=... or, at runtime, with TALK2TIA_PUBLICAPI_DIR.

The executable is src\Talk2Tia.Server\bin\<Configuration>\net48\talk2tia.exe.

Configure an MCP client

Claude Code

claude mcp add talk2tia -- "C:\Program Files\Talk2Tia\talk2tia.exe"

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "talk2tia": {
      "command": "C:\\Program Files\\Talk2Tia\\talk2tia.exe",
      "env": { "TALK2TIA_TOOLSETS": "all" }
    }
  }
}

Environment variables

Variable Default Purpose
TALK2TIA_TOOLSETS all Comma-separated toolsets to expose: portal,hardware,plc,online,library,hmi,object. Fewer tools = less context for the model.
TALK2TIA_PUBLICAPI_DIR from registry Folder containing Siemens.Engineering.*.dll (V21, net48).

First session

  1. Open TIA Portal and your project (or let the assistant start one with portal_start).
  2. Ask the assistant to connect: it calls portal_attach. TIA Portal shows the Openness access dialog — confirm it.
  3. Work in natural language, e.g.
    • “List the blocks of PLC_1 that are not consistent and compile the software.”
    • “Read FB_Conveyor in SCL, add a jam-detection timer and write it back.”
    • “Convert this network of OB1 (LAD) to use the new motor FB.”
    • “Create a library type from FB_Motor, release version 1.0.0 and update all PLCs.”
  4. Changes are live in the open project but not saved until project_save (or Save in TIA Portal).

How code editing works

Language Read Write
SCL / STL / DB / UDT plc_read_block / plc_read_type with format scl plc_write_scl (source text, through a temporary external source)
LAD / FBD (KOP / FUP) plc_read_block with format document (SIMATIC SD .s7dcl + .s7res) plc_write_document
Any language format xml (SimaticML) plc_write_xml

Always run plc_compile after writing code: the tool returns errors and warnings with their location.

Safety

Known limitations

Disclaimer

Talk2Tia is provided “as is”, without warranty of any kind. InsideApp S.r.l. accepts no liability for any damage, loss of data, production downtime, injury or other consequence arising from its use, including changes made by AI assistants to projects, PLC programs or plants. Every change must be reviewed, tested and approved by qualified personnel before it reaches a real machine. See the LICENSE and the legal notice on the website for the full terms.