# PLCWare - TIA Portal (tia)

PLCWare - TIA Portal (tia) is an MCP server for automating Siemens TIA Portal V21 from Claude Code, Cursor, Copilot, and other AI editors. It creates devices, compiles code, and deploys projects from prompts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 repo stars
- Author: renanlido
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/renanlido/tia-openness
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/plcware-tia-portal-tia

## What it does

PLCWare runs a local HTTP/JSON API that wraps Siemens Openness, the official automation interface for TIA Portal V21. The MCP server `@renanlido/tia-openness-mcp` connects this API to your AI editor, enabling it to create devices and networks, author and import SCL/SimaticML blocks, manage tags and types, compile, and download projects to target hardware.

The application runs on Windows and requires .NET Framework 4.8 plus a local TIA Portal V21 installation with the Openness component. Download is free; usage requires an activation license (a 30-day trial is available without a card). The MCP client is MIT-licensed.

For advanced workflows, install the `tia-harness` Claude Code plugin—a set of skills and subagents that convert a structured project spec into a verified TIA file.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TIA_API_BASE`, `TIA_MCP_MODE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env TIA_API_BASE=<TIA_API_BASE> --env TIA_MCP_MODE=<TIA_MCP_MODE> --transport stdio plcware-tia-portal-tia -- npx -y @renanlido/tia-openness-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add plcware-tia-portal-tia --env TIA_API_BASE=<TIA_API_BASE> --env TIA_MCP_MODE=<TIA_MCP_MODE> -- npx -y @renanlido/tia-openness-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "plcware-tia-portal-tia": {
            "command": "npx",
            "args": [
                "-y",
                "@renanlido/tia-openness-mcp"
            ],
            "env": {
                "TIA_API_BASE": "<TIA_API_BASE>",
                "TIA_MCP_MODE": "<TIA_MCP_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "plcware-tia-portal-tia": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@renanlido/tia-openness-mcp"
            ],
            "env": {
                "TIA_API_BASE": "<TIA_API_BASE>",
                "TIA_MCP_MODE": "<TIA_MCP_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TIA_API_BASE=<TIA_API_BASE> -e TIA_MCP_MODE=<TIA_MCP_MODE> plcware-tia-portal-tia npx -y @renanlido/tia-openness-mcp
```
Replace <…> with your own values

## When to use it
- generate and import PLC blocks (LAD, FBD, SCL) without opening TIA Portal manually
- compile projects and deploy them to controllers through an API
- create devices, networks, and CPUs from text specifications
- manage tags, types, and block properties programmatically
- integrate TIA Portal into CI/CD pipelines and code generation workflows

## Example prompts
- "Create a CPU 1200 device in TIA Portal with IP 192.168.1.100"
- "Import an SCL block from this code and compile the project"
- "Export PLC blocks to SimaticML and download them to the controller"

## Similar
- [TiaCommander](https://affpapa.org/en/nevibecode/mcp/tiacommander.md) — MCP server · ★ 68 repo stars
- [iec61131](https://affpapa.org/en/nevibecode/skills/iec61131.md) — skill · 154 installs
- [developer-portal](https://affpapa.org/en/nevibecode/agents/developer-portal.md) — subagent · ★ 2858 repo stars
- [Modbus TCP/RTU Device](https://affpapa.org/en/nevibecode/mcp/modbus-tcprtu-device.md) — MCP server · ★ 32 repo stars
- [service-concierge-portal-generate](https://affpapa.org/en/nevibecode/skills/service-concierge-portal-generate.md) — skill · 1200 installs
- [pipefy-portal-setup](https://affpapa.org/en/nevibecode/skills/pipefy-portal-setup.md) — skill · 786 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
