# CODESYS MCP Toolkit

The CODESYS MCP Toolkit MCP server for Claude Code reads and edits Structured Text in CODESYS V3.5 projects. It compiles code and runs checks in the CODESYS simulation.

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

## What it does

The server gives an agent access to CODESYS project objects. It can inspect project structure, create or edit Structured Text, and compile the result. Code search is available too.

For testing, the server controls the CODESYS simulation: it can start it, step through cycles, and read or change values. It does not connect to real controllers. It requires Windows, CODESYS V3.5 with the Scripting add-on, and Node.js 20 or later.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add codesys-mcp-toolkit -- npx -y @codesys/mcp-toolkit
```

### Codex

**Platform CLI**
```bash
codex mcp add codesys-mcp-toolkit -- npx -y @codesys/mcp-toolkit
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "codesys-mcp-toolkit": {
            "command": "npx",
            "args": [
                "-y",
                "@codesys/mcp-toolkit"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "codesys-mcp-toolkit": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codesys/mcp-toolkit"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add codesys-mcp-toolkit npx -y @codesys/mcp-toolkit
```

## When to use it
- inspect objects and structure in a CODESYS project
- create or edit Structured Text code
- compile a project and retrieve errors
- test program behavior in the simulation

## Example prompts
- Inspect the CODESYS project tree and find `PLC_PRG`.
- Create a Structured Text function block and compile the project.
- Start the CODESYS simulation and check the output value.

## Similar
- [iec61131](https://affpapa.org/en/nevibecode/skills/iec61131.md) — skill · 154 installs
- [TiaCommander](https://affpapa.org/en/nevibecode/mcp/tiacommander.md) — MCP server · ★ 68 repo stars
- [PLCWare - TIA Portal (tia)](https://affpapa.org/en/nevibecode/mcp/plcware-tia-portal-tia.md) — MCP server · ★ 9 repo stars
- [Modbus TCP/RTU Device](https://affpapa.org/en/nevibecode/mcp/modbus-tcprtu-device.md) — MCP server · ★ 32 repo stars
- [es-toolkit](https://affpapa.org/en/nevibecode/skills/es-toolkit.md) — skill · 293 installs
- [mvvm-toolkit-di](https://affpapa.org/en/nevibecode/skills/mvvm-toolkit-di.md) — skill · 92 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
