On this page

  1. Install NodeLens & the UE5 Plugin
  2. Set up your Projects folder
  3. Send a Blueprint from Unreal Engine
  4. Explore the views
  5. Chat with AI about your Blueprints
  6. Connect Claude via MCP
  7. Load an existing NodeLens project
  8. Important: Blueprints are read-only mirrors

1 Install NodeLens & the UE5 Plugin

โฌ‡๏ธ
Download and install the NodeLens app Run the installer from releases.nodelens.io. Launch NodeLens and activate your license or start your free trial.
๐Ÿ”Œ
Install the UE5 Plugin Download the NodeLens plugin from the Fab marketplace and install it to your engine or project. Alternatively, copy the NodeLens plugin folder manually into your project's Plugins/ directory. Re-open your project โ€” you'll be prompted to compile the plugin. Click Yes.
โณ

Plugin pending Fab approval. The NodeLens UE5 plugin is currently under review on the Fab marketplace. Check back soon or follow us on X @nodelens_io for updates.

โš™๏ธ
Configure the plugin In Unreal Engine, go to Edit โ†’ Project Settings โ†’ Plugins โ†’ NodeLens. Set the Project Name (this will be the folder name in your NodeLens Projects Directory) and the Server URL (default: http://localhost:7823).
โœ…
Verify the plugin is active You should see a NodeLens button in the Blueprint editor toolbar. Make sure the NodeLens desktop app is running before you send anything.

2 Set up your Projects folder

NodeLens saves Blueprint data as plain .md files on your machine. Before you send anything, tell NodeLens where to store them.

โš™๏ธ
Open Settings Click the gear icon in the bottom-left of the NodeLens sidebar.
๐Ÿ“
Set your Projects Directory Choose a folder on your machine where NodeLens will store all your Blueprint projects โ€” for example Documents\NodeLens Projects. You can change this at any time.
๐Ÿ’ก

Each UE5 project you send becomes its own subfolder inside this directory. All files are plain Markdown โ€” you can open them in any text editor or Obsidian.

3 Send a Blueprint from Unreal Engine

NodeLens plugs directly into UE5 โ€” no copy-paste required.

๐Ÿ–ฑ๏ธ
From the Blueprint editor toolbar Open any Blueprint in Unreal Engine. Click the NodeLens button in the toolbar. The Blueprint is sent to NodeLens instantly.
๐Ÿ“ฆ
From the Content Browser (right-click) Right-click any asset โ€” DataTable, Struct, Enum, Material, or DataAsset โ€” and choose NodeLens โ†’ Send to NodeLens.
๐Ÿ’ก

The project name is set in the UE5 plugin settings (Edit โ†’ Project Settings โ†’ Plugins โ†’ NodeLens). Make sure it matches an existing project in NodeLens, or NodeLens will create a new one automatically.

4 Explore the views

Once a Blueprint is loaded, you can switch between several views using the tab bar at the top of the viewer:

๐ŸŽจ
Canvas Interactive node graph โ€” drag nodes, zoom, pan, and inspect wire connections. The closest you can get to the Blueprint editor without opening UE5.
๐Ÿ“„
Pseudocode The Blueprint logic rendered as readable pseudocode. Great for understanding what a function does at a glance.
๐ŸŒณ
Exec Tree A hierarchical view of the execution flow โ€” useful for tracing branches and loops.
๐Ÿ“
Notes (.md) Every Blueprint gets a Markdown notes file. Add your own documentation, observations, or AI-generated summaries here. Changes are saved automatically.

5 Chat with AI about your Blueprints

The built-in AI chat lets you ask questions about your Blueprints in plain English. NodeLens sends your Blueprint context directly to your chosen AI provider โ€” no middleman.

๐Ÿ”‘
Add your API key Open the chat panel (right side). Select your provider from the dropdown โ€” OpenAI, Claude, Grok, Gemini, or local Ollama. Paste your API key in Settings.
โž•
Add Blueprint context Click + Context in the viewer toolbar to attach the current Blueprint to your chat. The AI will receive it as structured context โ€” not raw node data.
๐Ÿ’ฌ
Ask anything Examples: "What does the Add Item function do?" ยท "Is there a bug in this logic?" ยท "How would I add a stack limit check?"
๐Ÿ”’

Your data stays yours. API calls go directly from your machine to your chosen provider. NodeLens never sees your Blueprint content or your API key.

6 Connect Claude via MCP

If you use Claude Desktop, you can connect NodeLens as an MCP server. This lets Claude read all your saved Blueprints directly โ€” no copy-paste, no context window limits.

๐Ÿ“‹
Open the Claude Desktop config file The config file is located at %APPDATA%\Claude\claude_desktop_config.json. Open it in any text editor (e.g. Notepad). If the file doesn't exist, create it.
โœ๏ธ
Add the NodeLens MCP entry Paste the following inside the mcpServers object โ€” replace the path with the actual location of your NodeLens MCP server file:
{
  "mcpServers": {
    "nodelens": {
      "command": "node",
      "args": ["C:\\Users\\YourName\\AppData\\Local\\Programs\\NodeLens\\resources\\mcp-server\\index.js"]
    }
  }
}
โœ…
Save and restart Claude Desktop After restarting, Claude will have access to all your NodeLens projects. You can ask it to read, analyze, or generate Blueprint logic across your entire codebase.
๐Ÿ’ก

MCP works best for cross-Blueprint analysis โ€” asking Claude to understand how multiple Blueprints interact, find patterns, or generate new logic based on your existing code style.

7 Load an existing NodeLens project

If you already have a NodeLens project folder from a previous install or another machine, you can load it in seconds.

๐Ÿ“‚
Use "Load Project from Folder" Click the โ†“ arrow icon next to the PROJECTS header in the sidebar. Select the root folder of your existing NodeLens project. NodeLens will scan it and import all Blueprints and notes automatically.
โš™๏ธ
Or point to the same Projects Directory If you're reinstalling NodeLens on the same machine, just set the Projects Directory in Settings to your existing folder โ€” everything will appear in the sidebar automatically.

8 Blueprint Data & Snapshots

NodeLens creates a structured snapshot of your Blueprints when you send them from Unreal Engine. These files represent the state of your Blueprint at that moment โ€” they are not a replacement for your Unreal project files.

โš ๏ธ

Always make Blueprint changes in Unreal Engine first. If you update a Blueprint and send it to NodeLens again, the new snapshot will replace the previous NodeLens data. Any manual edits made inside NodeLens will not be preserved.

AI-Generated Blueprint Changes

When using AI features (chat or MCP) to generate or modify Blueprint logic, always save the result to a new folder (for example, Fixes) โ€” never overwrite the original. This keeps your source Blueprint safe from accidental changes.

1๏ธโƒฃ
Review AI suggestions Check the generated logic in NodeLens before applying anything.
2๏ธโƒฃ
Apply changes in Unreal Engine Implement the changes manually in your UE5 project.
3๏ธโƒฃ
Send the updated Blueprint back to NodeLens Re-send from UE5 to refresh the snapshot and keep NodeLens up to date.

Roadmap & Future Updates

NodeLens is actively developed and continuously improved. New Unreal Engine workflows, AI capabilities, and quality-of-life improvements are regularly added to make the workflow faster and more powerful.

๐Ÿ“ฃ

Follow @nodelens_io on X to stay up to date with the latest releases and features.


Ready to get started?

Download NodeLens and start understanding your Blueprints in minutes. 7-day free trial, no credit card required.

Download NodeLens