MCP Directory

How to add Unreal MCP to Claude Desktop

Control Unreal Engine 5.5 from AI clients — spawn actors, build Blueprints, and wire node graphs via natural language. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 2.0k★ · stdio · no auth

Claude Desktop config for Unreal MCP

uv --directory <path/to/unreal-mcp/Python> run unreal_mcp_server.py
{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path/to/unreal-mcp/Python>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Unreal MCP config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Unreal MCP's tools appear under the 🔌 tools menu.

Before you start

  • Unreal Engine 5.5+
  • Python 3.12+ and the uv package manager
  • The UnrealMCP plugin built into your project (or use the bundled MCPGameProject starter) — requires generating VS project files and building the Development Editor target
  • An MCP client such as Claude Desktop, Cursor, or Windsurf

What Unreal MCP can do in Claude Desktop

get_actors_in_level

List all actors in the current level

find_actors_by_name

Find actors matching a name pattern

spawn_actor

Create actors (cubes, spheres, lights, cameras, etc.)

delete_actor

Remove an actor from the level

set_actor_transform

Set an actor's position, rotation, and scale

get_actor_properties

Query an actor's properties

set_actor_property

Set a property on an actor

spawn_blueprint_actor

Spawn an actor from a Blueprint class

Security

The Python server relays commands to an unauthenticated localhost TCP socket (port 55557) that controls your Unreal Editor — it can spawn and delete actors and rewrite Blueprints, so only use it on projects under version control. The author labels it experimental, and there have been no updates since April 2025; newer UE versions may break it.

Unreal MCP + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Unreal MCP config there under the "mcpServers" key and restart the client.

Is Unreal MCP safe to use with Claude Desktop?

The Python server relays commands to an unauthenticated localhost TCP socket (port 55557) that controls your Unreal Editor — it can spawn and delete actors and rewrite Blueprints, so only use it on projects under version control. The author labels it experimental, and there have been no updates since April 2025; newer UE versions may break it.

Is unreal-mcp safe to run on my game project?

It's free, MIT-licensed, and local-only, but it drives your editor over an unauthenticated localhost TCP port and is officially experimental — commit your project to version control first and expect breaking changes. With no commits since April 2025, newer UE releases may not work without fixes.

Does it work with Unreal Engine 4 or older UE 5 versions?

No — it targets UE 5.5+, and the bundled starter project is a UE 5.5 blank project. Older engine versions aren't supported, and given the repo's inactivity, forward compatibility with newer versions isn't guaranteed either.

Do I have to use the bundled sample project?

No. MCPGameProject just saves setup time; you can copy Plugins/UnrealMCP into any existing project, regenerate project files, build, and enable the plugin. The Python server and client config are identical either way.

View repo Full Unreal MCP page