WAGO PLC

Official

by WagoAlex · Python

Read and monitor WAGO PLC parameters over the WDA REST API. Read-only unless writes are allowed.

io.github.WagoAlex/wago-plc-mcp-server (MCP)

This MCP server reads and monitors WAGO PLC parameters via the WDA REST API. Its primary function is to expose PLC parameter data for external consumption, with access described as read-only unless writes are allowed.

🛠️ Key Features

Read WAGO PLC parameters over the WDA REST API
Monitor PLC parameters
Read-only by default; writes only if permitted

🚀 Use Cases

Fetch current PLC parameter values from a WAGO PLC
Keep an external application updated by monitoring parameter changes

⚡ Developer Benefits

Integrates WAGO PLC parameter access through an MCP server interface
Uses the WDA REST API as the underlying data source

⚠️ Limitations

Limited to WAGO PLC parameters accessible via the WDA REST API
Write operations are not guaranteed; behavior depends on whether writes are allowed

README.md4 KBView on GitHub

wago-plc-mcp-server - bridge WAGO PLCs to AI agents

wago-plc-mcp-server

This MCP server connects Claude and other AI assistants to WAGO PLCs. You ask a question in plain English. The assistant gets the answer from the PLC. You do not need scripts or parameter IDs.

Overview demo

Quick start

You need Claude Desktop and a PLC that your computer can reach on the network.

Download wago-plc-mcp-server-<version>.mcpb from the latest release.
In Claude Desktop, go to Settings → Extensions.
Drag the .mcpb file onto the window.
In the form, enter the PLC IP address and the WBM password. Then save the form.
Ask Claude: "List my PLCs".

If the installer does not start on Windows, or if you have many PLCs, see Claude Desktop and Claude Code.

Try these questions

What firmware is running on 192.168.1.10?

Check the NTP status on all PLCs.

Show the diagnostic LED states on all PLCs.

For more examples and screen recordings, see Example questions.

Safe by default

The server only reads. It refuses all writes until you select Allow writes and method calls.
The server refuses reboot, factory reset, and firmware methods. An administrator can allow one exact method.
In GitOps mode, the server refuses file uploads. File uploads do not have a pull-request path yet.
An audit log records each write, each method call, and each file upload.

Read, write, and critical write paths from Claude to a WAGO PLC

For the full rules, see How it works.

Next steps

I want to...	Read
Connect many PLCs, install the WAGO skill, or watch the demos	Claude Desktop and Claude Code
Know what the server does on my PLCs	How it works
Run one server for a team	Deployment
Review each change in a pull request before it goes to a PLC	GitOps
Update firmware	Firmware updates
Configure TLS, API keys, and the audit log	Security
Find all tools and settings	Reference
Find an answer to a common question	FAQ

Supported devices: CC100, PFC100 G2, PFC200 G2, PFC300, Edge Controller, WP400, and TP600. For the tested firmware versions, see Supported hardware.

License

Mozilla Public License 2.0

Install

Configuration

Environment variables

TRANSPORTrequireddefault stdio

MCP transport. Fixed to stdio for this package.

WAGO_PLC_HOSTSrequired

Comma-separated IPs of the WAGO PLCs, reachable from this machine

DEFAULT_PLC_USERNAMErequireddefault admin

WBM username on the PLCs

DEFAULT_PLC_PASSWORDrequiredsecret

WBM password, same on all listed PLCs

WAGO_TIMEOUT_SECONDSdefault 45

WDA request timeout. CC100 needs 45 or more, other controllers work with 15

WAGO_ALLOW_WRITESrequireddefault false

true lets the agent change parameters, run methods and upload files. Anything else keeps every PLC read-only

AUDIT_LOG_FILE

Optional path for the tamper-evident audit log of writes and refusals

Arguments

--networkdefault host

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "wago-plc-mcp-server": {
      "command": "uvx",
      "args": [
        "wago-plc-mcp-server"
      ],
      "env": {
        "TRANSPORT": "stdio",
        "WAGO_PLC_HOSTS": "<YOUR_WAGO_PLC_HOSTS>",
        "DEFAULT_PLC_USERNAME": "admin",
        "DEFAULT_PLC_PASSWORD": "<YOUR_DEFAULT_PLC_PASSWORD>",
        "WAGO_TIMEOUT_SECONDS": "45",
        "WAGO_ALLOW_WRITES": "false",
        "AUDIT_LOG_FILE": "<YOUR_AUDIT_LOG_FILE>"
      }
    }
  }
}