totally-integrated-claude

A Claude Code plugin for Siemens TIA Portal engineering automation.

Provides a routed skill framework covering the full TIA Portal Openness API surface — Python TIA Scripting for everyday tasks and C# Openness for advanced object-model work — plus an LSP server for Siemens PLC source languages.

Features

Automatic routing - one entry-point skill (tia-openness-roadmap) selects Python or C# and loads the right domain skill
Python TIA Scripting - full coverage of PLC blocks/tags, HMI, libraries, devices, project lifecycle via tia-python
C# Openness - nine domain skills covering every Openness API area (see table below)
TIA Portal Add-In development — VS Code–based Add-In authoring workflow
LSP language server - syntax highlighting, diagnostics, and code intelligence for Siemens PLC source files
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=true and a server-issued safetyToken
Environment diagnostics - manually run tia-doctor to check TIA Portal, Openness, Python TIA Scripting, MCP, and LSP prerequisites

Skills

Skill	Purpose
`tia-openness-roadmap`	Entry point. Routes all TIA Portal tasks to the correct implementation path and domain skill. Load this first for every TIA Portal task.
`tia-doctor`	Manual diagnostic. Checks local prerequisites and reports exact remediation steps without mutating the machine.
`plc-code-analysis`	Standalone. Multi-perspective security and quality analysis for PLC code (SCL/LAD/FBD) via SimaticML or MCP.
`tia-portal-mcp`	Interactive. Direct TIA Portal interaction via MCP tools (browse tree, read/write logic, list tags, hardware config).
`tia-python`	Python TIA Scripting: PLC blocks/tags/UDTs, HMI tags/screens, library types/versions, project lifecycle, CAx import/export.
`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 lifecycle: open, create, save, archive, retrieve, 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# Unified HMI: screens, screen items, elements, parts, tags, alarms, scripts, cycles, connections, dynamization, events, runtime settings, system services.
`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: server project management, local sessions, multiuser commissioning workflows.
`tia-teamcenter`	C# Teamcenter Integration: Teamcenter storage management and Teamcenter-managed project operations.
`tia-testsuite`	C# TestSuite & Application Test: test sets, application tests, style-guide rules, automated system testing.
`addin-operations`	TIA Portal Add-In development: project structure, VS Code workflow, Add-In lifecycle, menus, permissions, deployment.

LSP Language Server

The plugin ships a compiled LSP server (bin/siemens-lsp.exe) providing language intelligence for Siemens PLC source files:

Extension	Language
`.scl`	Structured Control Language
`.st`	Structured Text (IEC 61131-3)
`.s7res`	S7 Resource
`.s7dcl`	S7 Declaration
`.udt`	User-Defined Type
`.db`	Data Block
`.awl`	Statement List (AWL/STL)

Prerequisites

For Python TIA Scripting

Siemens TIA Portal V17 or later
TIA Scripting Python downloaded from Siemens Industry Online Support
Python 3.12.x for the current siemens_tia_scripting wheel

For C# Openness

Siemens TIA Portal V17 or later
TIA Portal Openness assemblies (installed with TIA Portal)
.NET Framework 4.8 or later

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: