unreal-mcp-ue4 — Claude Code MCP server: features and setup
Connect an MCP client to an open Unreal Engine 4.27.2 project to inspect editor data and make changes through agent tools.
claude mcp add unreal-mcp-ue4 -- npx -y unreal-mcp-ue4What unreal-mcp-ue4 does
The server communicates with Unreal Editor through its built-in Python Remote Execution system. The manage_* tools provide project, map, and level information, while direct tools cover selected lower-level operations. For debugging or UE4.27 API calls without a dedicated wrapper, agents can use manage_editor.run_python.
You need Unreal Engine 4.27.2, Node.js 18+, and npm. Enable Python Editor Script Plugin, Editor Scripting Utilities, and Enable Remote Execution in the project; advanced sequence actions also require SequencerScripting. Connected clients can inspect and modify the open editor session, so test against a disposable project first. This repository does not install a custom Unreal plugin.
What it helps with
- inspect an Unreal project summary
- read map details and the level actor list
- create, update, or delete an actor
- run Python in the editor to test a UE4.27 API call
Example prompts for the agent
- Show me the open project's summary and current map.
- List the actors in this level and update the one I specify.
- Run Python in the editor to test this UE4.27 API call.
How to install unreal-mcp-ue4
Platform CLI
claude mcp add unreal-mcp-ue4 -- npx -y unreal-mcp-ue4Platform CLI
codex mcp add unreal-mcp-ue4 -- npx -y unreal-mcp-ue4Config file
{
"mcpServers": {
"unreal-mcp-ue4": {
"command": "npx",
"args": [
"-y",
"unreal-mcp-ue4"
]
}
}
}Config file
{
"servers": {
"unreal-mcp-ue4": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"unreal-mcp-ue4"
]
}
}
}Platform CLI
gemini mcp add unreal-mcp-ue4 npx -y unreal-mcp-ue4Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about unreal-mcp-ue4
How do I install unreal-mcp-ue4 in Claude Code?
Run claude mcp add unreal-mcp-ue4 -- npx -y unreal-mcp-ue4. Then enable Python Editor Script Plugin, Editor Scripting Utilities, and Enable Remote Execution in Unreal Editor.
What does unreal-mcp-ue4 do?
It connects an MCP client to an open Unreal Editor session through Python Remote Execution. An agent can inspect project and map details or perform actor operations.
Which Unreal Engine settings does the server need?
Use Unreal Engine 4.27.2 and enable Python Editor Script Plugin, Editor Scripting Utilities, and Enable Remote Execution. Advanced sequence actions also need SequencerScripting.
