How to use Claude Code with Unreal Engine

Connect Claude Code to a running Unreal Editor through Kismet’s local MCP server, so it can read, edit and compile Blueprints, materials and widgets as well as your C++.

6 min read

What Claude Code cannot see on its own

Claude Code works well on the C++ side of an Unreal project because C++ is text. The rest of the project is not. Blueprints, materials, widgets and animation assets are binary .uasset files, so a terminal agent cannot read them, and it cannot compile a Blueprint or see the editor log either.

Kismet closes that gap. It is a free, open-source editor plugin that runs a Model Context Protocol (MCP) server inside Unreal Editor. Claude Code connects to it and gets editor tools: reading and editing Blueprint graphs, compiling, searching the asset registry, reading the editor log, and working on materials, widgets, components and animation assets. Claude Code keeps its own model and its own loop. Kismet provides the tools, with the same validation and limits as its built-in panel.

Before you start

  • Unreal Engine 5.6, 5.7, 5.8 and 5.9 on macOS and Windows.
  • Kismet installed and enabled. The one-line installer is on the download page.
  • Claude Code installed and signed in.
  • Your project open in Unreal Editor. The MCP server starts with the editor, so there is nothing else to enable.

Connect Claude Code

  1. 1.

    Create and read the access token

    Kismet writes the token the first time the endpoint receives a request. Call it once (the 401 reply is expected), then read the file.

    curl -s -o /dev/null -X POST http://127.0.0.1:8323/mcp
    cat ~/.kismet/mcp_token
  2. 2.

    Add Kismet as an MCP server

    The token is read once, when you run the command, and stored in Claude Code’s own config.

    claude mcp add --transport http kismetai http://127.0.0.1:8323/mcp \
      --header "Authorization: Bearer $(cat ~/.kismet/mcp_token)"
  3. 3.

    Start Claude Code in your project folder

    Ask it to list the Blueprints in the project. If it answers from the asset registry, the connection works.

The token belongs to the install, not the editor session, so this setup survives editor restarts. If you set KISMETAI_PORT, use that port instead of 8323. Treat the token like a password.

Allow edits

Reading works as soon as Claude Code is connected. Changing assets needs a grant from you, because nobody can approve an MCP call while it runs. Give it in the editor console, limited to the folder the agent may change:

Unreal Editor console

KismetAI.Authority.Grant mcp edit,create /Game/Sandbox

Without a grant, a call that would change something returns AUTHORITY_REQUIRED and changes nothing. Deleting, renaming or moving assets needs the delete permission as well. Grants live in memory and end when the editor closes.

A first session

Start with a read-only question, then a small change you can check by eye.

Prompt to try
Read BP_Player and explain what happens when the jump input fires. Then check the C++ parent class for anything that overrides it.
Prompt to try
In /Game/Sandbox, add a Print String after Begin Play in BP_Test that prints "connected", then compile and show me the result.

This is where the combination pays off: one agent can follow a problem from a Blueprint graph into the C++ class behind it, change the C++ with its own file tools, and adjust the Blueprint through Kismet.

Limits to know

  • Tools run on the editor’s main thread, one call at a time. A long compile blocks other calls until it finishes.
  • A tool call cannot be cancelled once it starts.
  • Each reply is a single response. There is no streaming.
  • Changes made over MCP are not shown in the Kismet panel’s diff view. Keep the project in source control and review what changed.

Using a Claude subscription

Kismet’s own panel uses an API key for the provider you choose. If you would sooner use the Claude plan you already pay for, this MCP route is the way: you run Claude Code yourself with your subscription, and it calls Kismet’s tools. Kismet never signs in to your Claude account.

In the docs

Try it in your own project.

Kismet is free and open source. Install the plugin, connect a model, and ask for one small change.

Related guides