totally-integrated-claude
A Claude Code plugin for Siemens TIA Portal engineering automation.
Provides a routed skill framework for TIA Portal engineering automation: Siemens TIA Scripting Python V1.4.3 for its supported wrapper surface, audited C# Openness skills for advanced object-model work, and a dedicated Modular Application Creator path.
Features
- Scoped automation routing -
tia-openness-roadmaphonors an explicit implementation choice, then selects MCP, Python, C#, MAC Module Builder, diagnostic, or Add-In skills - Python TIA Scripting V1.4.3 - Siemens wrapper coverage for PLC data, generic HMI access, devices, libraries, and project workflows via
tia-python - C# Openness - eleven domain skills covering the V21 Openness domain assemblies (see table below)
- Modular Application Creator -
tia-mac-module-buildercovers the audited MAC V21.0.5 lifecycle, generated/custom ownership, resources, packaging, and qualification boundaries - TIA Portal Add-In development — VS Code–based Add-In authoring workflow
- TIA Portal MCP server - work with your agent directly in TIA Portal V21 (separate installation required, see below)
- MCP write safety hooks - Claude Code blocks TIA Portal writes unless the call includes
confirm=trueand a server-issuedsafetyToken - Environment diagnostics -
tia-doctorverifies the exact V21 executable, modular Openness core, and user group, with optional Python/MCP checks - Certified V21 API baselines - hosted CI validates committed installed-API evidence without requiring TIA Portal on the runner
Skills
| Skill | Purpose |
|---|---|
tia-openness-roadmap |
Automation entry point. Honors explicit scope/path constraints and routes engineering tasks. Pure exported-code review uses plc-code-analysis directly. |
tia-doctor |
Manual diagnostic. Read-only V21 executable/modular API/group probe, with optional Python and MCP checks. |
plc-code-analysis |
Standalone. Evidence-gated PLC security/quality analysis for raw SCL/ST, V21 SIMATIC SD, or schema-valid SimaticML. |
tia-portal-mcp |
Interactive. Direct TIA Portal interaction via MCP tools (browse tree, read/write logic, list tags, hardware config). |
tia-python |
Siemens TIA Scripting Python V1.4.3: wrapper-level PLC, HMI, device, library, project, CAx, CFC, project-text, master-copy, and Test Suite workflows. |
tia-csharp-common |
C# foundation: TIA Portal process attach, ExclusiveAccess, Transaction, disposable patterns. Required first load for every C# task. |
tia-project-general |
C# project, portal, and library lifecycle: open/create/save/archive/retrieve, project/global libraries, master copies, type/version workflows, UMAC/UMC, language settings, diagnostics. |
tia-devices-general |
C# device & device-item operations: hardware catalog, device creation/deletion, slot/subslot traversal, software containers, network connections, hardware parameters. |
tia-plc-operations |
C# PLC software engineering: program/system blocks, PLC tags/UDTs, software units, Safety, alarms, OPC-UA, technological objects, watch/force tables, online/download, compare. |
tia-hmi-operations |
C# HMI Classic and Unified: separate object models for targets/software, screens/items, tags, alarms, scripts, connections, logging, runtime settings, and compile/import/export. |
tia-networks |
C# topology: subnets, nodes, IO systems, port channels, addresses, IO timing. |
tia-simatic-drives |
C# Startdrive / SINAMICS: drive controller access, drive engineering, motion control, download. |
tia-import-export |
C# & Python import/export: SimaticML, AML/CAx, PLC blocks, HMI screens/tags/alarms, hardware AML, project data. |
tia-multiuser |
C# Multiuser Engineering: project-server connections, server-project identity, local/exclusive sessions, marking, locking, save/discard/commit. |
tia-teamcenter |
C# provider-based Teamcenter Gateway: connection, search/download, dataset locking, and project/global-library save workflows. |
tia-testsuite |
C# TestSuite & Application Test: test sets, application tests, style-guide rules, automated system testing. |
tia-sivarc |
C# SiVArc: rule tables and libraries, definitions, expression resolution, layout exchange, and guarded visualization generation. |
tia-mac-module-builder |
Modular Application Creator and Module Builder: TiaEquipmentModule lifecycle, models/use cases, .tiares, generated/custom ownership, packaging, and qualification. |
addin-operations |
TIA Portal Add-In development: project structure, VS Code workflow, Add-In lifecycle, menus, permissions, deployment. |
Prerequisites
For Python TIA Scripting
- TIA Scripting Python V1.4.3 downloaded from Siemens Industry Online Support
- Python 3.12.x, 3.13.x, or 3.14.x with the matching Windows x64 wheel
- TIA Portal and Openness V15.1 or later according to the V1.4.3 manual; Siemens package metadata separately lists V18-V21, so verify the exact installed target
For C# Openness
- Siemens TIA Portal V21 for these audited API references
- V21 modular Openness API, including
Siemens.Engineering.Base.dllunderPublicAPI\V21\net48 - .NET Framework 4.8 or later
For Modular Application Creator
- Siemens Modular Application Creator and Module Builder matching the target project; the audited skill baseline is MAC V21.0.5
- TIA Portal V21 and its matching Openness PublicAPI for the audited baseline
- .NET Framework 4.8 and access to the project's approved MAC/Module Builder package source
For Add-In development
- Visual Studio 2022 or VS Code with C# Dev Kit
- TIA Portal Add-In SDK (available from Siemens Industry Online Support)
TIA Scripting Python is not installed from PyPI by package name. Download the TIA Scripting Python ZIP from Siemens, then use one of Siemens' supported setup paths:
- File import: unzip it and set
TIA_SCRIPTINGto the directory containingsiemens_tia_scripting.pydand the supplied adapter DLLs. - Wheel install: from the extracted package's
installdirectory, install the V1.4.3 wheel whose CPython tag matches the interpreter, for example:
cd C:\Path\To\Your\TIA_Scripting_Python\install
py -3.12 -m pip install .\siemens_tia_scripting-1.4.3-cp312-cp312-win_amd64.whl
To check a local machine, run the bundled doctor probe:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File skills\tia-doctor\probe.ps1 -RequiredMajorVersion 21
For machine-readable output:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File skills\tia-doctor\probe.ps1 -RequiredMajorVersion 21 -Json
For a C#-only V21 check while Python and MCP are intentionally out of scope:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File skills\tia-doctor\probe.ps1 -RequiredMajorVersion 21 -SkipPython -SkipMcp
Installation
Install from GitHub or clone this repository and link it locally while developing.
Claude Code
/plugin marketplace add Czarnak/totally-integrated-claude
Codex
Install the marketplace from GitHub:
codex plugin marketplace add Czarnak/totally-integrated-claude
From inside an interactive Codex session, you can use the slash-command form:
/plugin marketplace add Czarnak/totally-integrated-claude
Usage
Start every TIA Portal task by asking Claude to load the routing skill:
How do I read all PLC tag tables from an open TIA Portal project?
Claude will load tia-openness-roadmap, select the correct implementation path (MCP, Python, C#, MAC Module Builder, diagnostic, or Add-In), and load the matching focused skill automatically.
TIA Portal MCP write safety
TIA Portal MCP write tools use a preview-then-apply workflow. First call the matching preview_* tool, review the summary/diff and currentStateHash, then pass the returned safetyToken to the write tool with confirm=true.
Examples:
| Write | Required preview |
|---|---|
update_block_logic |
preview_update_block_logic |
create_tag_table, delete_tag_table |
preview_create_tag_table, preview_delete_tag_table |
create_tag, update_tag, delete_tag |
preview_create_tag, preview_update_tag, preview_delete_tag |
create_user_constant, update_user_constant, delete_user_constant |
matching preview_*_user_constant tool |
add_network_device, configure_network_device |
preview_add_network_device, preview_configure_network_device |
open_project, create_project, save_project, save_project_as, archive_project, close_project |
matching preview_*_project tool |
Claude Code also loads hooks/tia-write-guard.ps1 through hooks/hooks.json as defense-in-depth. The MCP server is still the authority: other clients must use the same preview token flow.
Environment diagnostics
Use tia-doctor when TIA Portal automation fails because of missing local
prerequisites. It is a read-only PowerShell probe that checks the exact V21 Portal
executable, Siemens.Engineering.Base.dll and installed modular API metadata, and
membership in the Siemens TIA Openness Windows user group. Python TIA Scripting
and tia-mcp checks are optional and can be skipped independently.
Routing examples
| Task | Path | Domain skill |
|---|---|---|
| Explore project structure interactively | MCP | tia-portal-mcp |
| Analyze raw SCL/ST, SIMATIC SD, or SimaticML for security issues | Standalone | plc-code-analysis |
| Read/write PLC blocks and tags | Python | tia-python |
| HMI screen access and export | Python | tia-python |
| Device slot/subslot manipulation | C# | tia-devices-general |
| Subnet and IO-system configuration | C# | tia-networks |
| SINAMICS drive engineering | C# | tia-simatic-drives |
| Advanced PLC online/security services | C# | tia-plc-operations |
| Multiuser Engineering (server projects) | C# | tia-multiuser |
| Teamcenter managed projects | C# | tia-teamcenter |
| Automated PLC/HMI testing | C# | tia-testsuite |
| SiVArc rules or visualization generation | C# | tia-sivarc |
Modular Application Creator module or .tiares work |
MAC Module Builder | tia-mac-module-builder |
| TIA Portal Add-In project | C# | addin-operations |
Worth installing to boost your workflow
- C# LSP plugin from Claude Plugins Official
- Tia Portal MCP Server
Contributing
See CONTRIBUTING.md for contributor setup, validation commands, test expectations, skill authoring rules, and safety requirements. Maintainers certifying a new Openness API surface should also follow the V21 API baseline workflow.
Sources
Examples
- PLC Block Scanner - as simple as possible, strictly as an example.
- TIA Git Add-In - Add-In for TIA Portal V21 making version control comfortable for PLC engineers.
License
MIT — see LICENSE.