Article

How to Set Up Blender MCP on Windows: Blender 5.2, uv and Your AI Assistant

Published 26 September 2026

Blender MCP lets an AI assistant work inside a live Blender scene. This is the setup we used on Windows: Blender 5.2 LTS, the uv package manager, an MCP server, the Blender add-on, and a first test. Allow about ten minutes.

Blender MCP can run Python code inside Blender. Save your work before you use it, and start with a blank scene.

What you need

  • Blender. Blender 5.2 LTS was released on 14 July 2026, and the current build at the time of writing is 5.2.2. The project itself says Blender 3.0 or newer.
  • Python 3.10 or newer. The uv tool below manages this for you.
  • uv, a Python package manager that runs the MCP server.
  • An AI client that supports MCP, such as Claude Desktop, Claude Code, Codex or Cursor.

Blender MCP is a third-party community project (MIT licensed). It is not made or endorsed by the Blender Foundation. Its package was recently renamed MCP for Blender, and older setups keep working. We cover the general idea, and why we use it, in our article on Blender MCP for construction training.

The five steps

Step 1

Install Blender 5.2 LTS

Download the Windows installer from blender.org, run it, and open Blender once to make sure it starts. The download page also offers a portable zip if you prefer not to install. Choose an install location you will remember, such as a short folder path on a fast drive.

Step 2

Install uv

Open PowerShell and run the official installer. Use this route, not pip install uv, which may not create the uvx command your AI client needs:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

If you see an execution policy error, as we did on one machine, PowerShell needs a policy of RemoteSigned, Unrestricted or Bypass. The usual fix is Set-ExecutionPolicy RemoteSigned -Scope CurrentUser. Only change this on a computer you control and are comfortable changing. Then close and reopen PowerShell, and check that uv --version works.

Step 3

Add the server to your AI client

Pick the client you use. The commands below come from the project’s own instructions.

Claude Code: claude mcp add blender uvx mcp-for-blender

Codex: codex mcp add blender -- uvx mcp-for-blender

Claude Desktop (Settings, Developer, Edit Config):
{ "mcpServers": { "blender": { "command": "uvx", "args": ["mcp-for-blender"] } } }

Common Windows problem: a desktop app that cannot find uvx shows an error such as spawn uvx ENOENT. Use the full path to uvx (find it with where uvx) as the command, then fully quit the app from the system tray and reopen it. Run only one MCP server at a time, not two clients at once.

Step 4

Install the Blender add-on

From a terminal, run the installer, which copies the add-on into your Blender add-ons folder:

uvx mcp-for-blender install-addon

Then open Blender, go to Edit, Preferences, Add-ons, search for “MCP for Blender” and tick Interface: MCP for Blender. If the command cannot find your Blender, download addon.py from the project’s GitHub page and use Install… in the same Add-ons window instead.

Step 5

Connect and test

In the 3D viewport, press N to open the sidebar, choose the MCP for Blender tab, and start the server. Keep Blender open. The add-on listens on port 9876 by default, and your AI client talks to it from there. Then ask your assistant:

Get information about the current scene.

On a fresh scene it should report the default Cube, Light and Camera. When that works, try: Get information about the current scene, and make a Three.js sketch from it. That is one of the project’s own example prompts.

If it does not connect

Work through these in order:

  1. Check that Blender is open, the add-on is enabled, and the server has been started in the sidebar.
  2. Check that the MCP server is set up in your AI client. Do not run the uvx command by hand in a terminal.
  3. The first request sometimes fails and later ones work, so try again.
  4. Restart both the AI client and the Blender server.
  5. For time-outs, break a large request into smaller steps.
  6. If a new Blender release will not enable the add-on, check the project’s GitHub issues, or try the current LTS again after updating the add-on with the install-addon command.

Safety and privacy

A few points worth knowing before you point an AI at your files:

  • It can run code. The project warns that its code-execution tool can run arbitrary Python in Blender. Always save your work first.
  • Downloads. Optional asset sources such as Poly Haven download files into your scene, and Blender can freeze until a large download finishes. Turn these off in the sidebar if you do not want them.
  • Telemetry. According to the project, collecting your prompts, code and scene data is opt-in and off by default, but a minimal anonymous usage record is collected unless you set the DISABLE_TELEMETRY environment variable to true.
  • Keep client work private. Avoid putting confidential drawings, client details or API keys into prompts or scenes unless your policy allows it.

Links

Download Blender MCP for Blender Project on GitHub Install uv Blender MCP for construction training

Keep reading

More on AI, construction, education and project management.

Browse all articles AI resources

Use AI as a guide, not the final word

AI is powerful, but it can be wrong or out of date. Steps and settings change between versions, so check the project’s current instructions before you rely on them. Always review the outputs yourself, and make sure any codes, standards or regulations involved are current and match your local specifications.

Scroll to Top