Documentation

Everything you need to install, configure, and use TIA Portal MCP.

Requirements

  • Windows 10 or Windows 11 (64-bit)
  • Siemens TIA Portal V17, V18, or V19 installed and licensed
  • TIA Portal Openness license (included in most Engineering licenses)
  • .NET Framework 4.8 or later
  • Cursor IDE or Claude Desktop (latest version)

Installation

  1. Download the TIA Portal MCP installer from the link in your purchase email.
  2. Run TIAPortalMCP-Setup.exe and follow the installation wizard.
  3. The installer will automatically detect your TIA Portal version.
  4. Note the installation path shown at the end of setup — you will need it in the next step.

Configure Cursor IDE

Open your Cursor settings file at %APPDATA%\Cursor\mcp.json and add the following:

{
  "mcpServers": {
    "tia-portal": {
      "command": "C:\\Program Files\\TIA Portal MCP\\server.exe",
      "args": []
    }
  }
}

Replace the path with your actual installation path if different. Restart Cursor after saving.

Configure Claude Desktop

Open %APPDATA%\Claude\claude_desktop_config.json and add:

{
  "mcpServers": {
    "tia-portal": {
      "command": "C:\\Program Files\\TIA Portal MCP\\server.exe",
      "args": []
    }
  }
}

Restart Claude Desktop after saving.

First steps

  1. Start TIA Portal normally — open or create a project.
  2. Open Cursor or Claude Desktop.
  3. Try a simple command: “List all PLCs in the current TIA Portal project”
  4. The AI will confirm it is connected and return your project structure.

Example prompts

“Open project at C:\Projects\MyPlant.ap19”
“Create a function block called FB_ConveyorControl with start, stop and fault outputs”
“Add a 16-channel DI module to rack 0, slot 3”
“Compile the project and fix any errors”
“Download the program to CPU 1515-2 PN”
“List all tags in the default tag table”
“Create an HMI screen called Overview with a start and stop button”

Troubleshooting

AI says it cannot connect to TIA Portal

Make sure TIA Portal is running and a project is open before sending commands. The MCP server requires TIA Portal to already be started.

TIA Portal Openness access denied error

Run TIA Portal as Administrator, or add your user account to the Siemens TIA Openness Windows user group.

MCP server not showing up in Cursor

Check that the path in mcp.json is correct and uses double backslashes. Restart Cursor after any config change.

Still stuck?

Email us at info@tiaportalmcp.com with a description of the issue and your TIA Portal version.

Privacy & analytics

This website uses Plausible Analytics — a privacy-friendly, cookieless analytics tool hosted in the EU. No personal data is collected, no cross-site tracking, and nothing is shared with third parties. The MCP server itself runs entirely on your local machine and never sends project data to any external server.