CODESYS
A Model Context Protocol server that enables seamless interaction between MCP clients (like Claude Desktop) and CODESYS V3 programming environments, allowing automation of project management, POU creation, code editing, and compilation tasks.
What is CODESYS?
CODESYS is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that enables seamless interaction between mcp clients (like claude desktop) and codesys v3 programming environments, allowing automation of project management, pou creati...
A Model Context Protocol server that enables seamless interaction between MCP clients (like Claude Desktop) and CODESYS V3 programming environments, allowing automation of project management, POU creation, code editing, and compilation tasks.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that enables seamless intera
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx codesys-mcp-toolkitConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use CODESYS
The CODESYS MCP Toolkit is a Model Context Protocol server that bridges AI assistants like Claude Desktop with CODESYS V3 industrial automation IDE environments, enabling natural-language automation of PLC programming tasks. Through the MCP connection, Claude can open and create CODESYS projects, create Programs, Function Blocks, and Functions (POUs), write and read IEC 61131-3 code, compile projects, and inspect the project structure — all by controlling CODESYS through its built-in Python Scripting Engine. This dramatically accelerates PLC development workflows by letting engineers describe automation logic in plain language.
Prerequisites
- CODESYS V3 (version 3.5 SP21 or later) installed with the Scripting Engine feature enabled
- Node.js 18.0.0 or later installed
- An MCP-compatible client such as Claude Desktop
- Windows OS (CODESYS runs on Windows)
Install the CODESYS MCP Toolkit globally
Install the npm package globally so the codesys-mcp-tool command is available system-wide. This is the recommended approach over using npx.
npm install -g @codesys/mcp-toolkitLocate your CODESYS executable path
Find the full path to your CODESYS.exe installation. The default path is typically inside Program Files under the CODESYS version folder.
# Typical path on Windows:
# C:\Program Files\CODESYS 3.5.21.0\CODESYS\Common\CODESYS.exeAdd the server to your MCP client configuration
Open your claude_desktop_config.json and add the CODESYS server entry with the path to your CODESYS.exe and your profile name.
{
"mcpServers": {
"codesys_local": {
"command": "codesys-mcp-tool",
"args": [
"--codesys-path", "C:\\Program Files\\CODESYS 3.5.21.0\\CODESYS\\Common\\CODESYS.exe",
"--codesys-profile", "CODESYS V3.5 SP21"
]
}
}
}Restart Claude Desktop
Quit and reopen Claude Desktop. The CODESYS MCP Toolkit server will start CODESYS via its scripting engine when the first tool call is made.
Verify the connection with a status check
Ask Claude to check the CODESYS project status using the codesys://project/status resource. This confirms the scripting engine is connected and ready.
CODESYS Examples
Client configuration
Claude Desktop configuration for the CODESYS MCP Toolkit. Adjust the codesys-path and codesys-profile to match your installation.
{
"mcpServers": {
"codesys_local": {
"command": "codesys-mcp-tool",
"args": [
"--codesys-path",
"C:\\Program Files\\CODESYS 3.5.21.0\\CODESYS\\Common\\CODESYS.exe",
"--codesys-profile",
"CODESYS V3.5 SP21",
"--workspace",
"C:\\Users\\YourName\\Documents\\CODESYS"
]
}
}
}Prompts to try
Natural-language commands for CODESYS PLC programming tasks.
- "Create a new CODESYS project called MyPLCProject and save it to my workspace."
- "Add a Function Block called MotorController with ST (Structured Text) language."
- "Write a ladder logic program in PLC_PRG that turns on output Q0 when input I0 is TRUE."
- "Compile the current project and show me any errors."
- "Show me the structure of the currently open CODESYS project."Troubleshooting CODESYS
Error: CODESYS.exe not found at the specified path
Double-check the exact path to your CODESYS.exe. The path varies by version — open File Explorer and navigate to Program Files to find the correct path. Use double backslashes in the JSON config.
CODESYS scripting engine fails to initialize
Ensure the CODESYS Scripting Engine is enabled in your installation. Open CODESYS, go to Tools → Options → Scripting and verify the engine is active. You may need to reinstall CODESYS with the Scripting Engine component selected.
codesys-mcp-tool command not found after npm install
The global npm bin directory may not be in your PATH. Run 'npm bin -g' to find where global packages are installed and add that directory to your system PATH environment variable.
Frequently Asked Questions about CODESYS
What is CODESYS?
CODESYS is a Model Context Protocol (MCP) server that model context protocol server that enables seamless interaction between mcp clients (like claude desktop) and codesys v3 programming environments, allowing automation of project management, pou creation, code editing, and compilation tasks. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install CODESYS?
Follow the installation instructions on the CODESYS GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with CODESYS?
CODESYS works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is CODESYS free to use?
Yes, CODESYS is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
CODESYS Alternatives — Similar Coding Agents Servers
Looking for alternatives to CODESYS? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up CODESYS in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use CODESYS?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.