Skip to content
MCP Shelf

Pod to App: Claude Code

How to install Blender MCP in Claude Code

By Sophie Filer · Updated 11 Nov 2026 · Steps checked against Blender MCP's own docs on 11 Nov 2026

The short answer

Run claude mcp add blender uvx mcp-for-blender, then enable the MCP for Blender addon in Blender and click Start MCP Server in its sidebar tab. If you have not set up the addon yet, uvx mcp-for-blender setup installs it and configures Claude Code in one go.

Terminal
claude mcp add blender uvx mcp-for-blender
Needs
Blender 3.0+, uv
Runs on
Your machine
Sign-in
None
Price
Free, open source

The one-command route

The project has an installer that finds the AI apps on your machine, Claude Code included, asks which to set up, and installs and enables the Blender addon. It keeps your existing configs and saves a .bak of anything it changes.

Terminal (macOS or Linux)
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

On Windows use irm https://www.mcp-for-blender.com/install.ps1 | iex in PowerShell. If you already have uv, uvx mcp-for-blender setup does the same without the script.

Or set it up by hand

  1. Step 1: Install uv with its official installer (brew install uv on macOS, winget install --id=astral-sh.uv -e on Windows).
  2. Step 2: Add the server to Claude Code with the command at the top of this page. Add --scope user after add if you want it in every project.
  3. Step 3: Install the addon: uvx mcp-for-blender install-addon, then in Blender enable Interface: MCP for Blender under Edit, Preferences, Add-ons.
  4. Step 4: In the 3D viewport press N, open the MCP for Blender tab and click Start MCP Server.
  5. Step 5: Start Claude Code, run /mcp to see blender connected, and ask for something small first: "Add a table with four chairs around it."

What Claude Code can do in Blender

Claude Code writes Blender Python for modelling, materials, animation and rigging. The server adds the things Python cannot do alone:

ToolWhat it is for
execute_blender_codeRun Python in your open Blender
lookSee the result from the viewport, the camera or several angles, in solid, material or rendered view
get_scene_infoA compact summary of every object in the scene
search_assets / import_assetPull models, textures and HDRIs from Poly Haven, Sketchfab and Poly Pizza
generate_3dCreate a model with a generator such as Tripo, Hunyuan3D, Rodin or Meshy, where you have access

Pin Python if the install fails

On machines with conda, pyenv or a very new Python, uv can pick an interpreter that breaks the install. Re-add the server with Python pinned:

Terminal
claude mcp add blender -e UV_PYTHON_PREFERENCE=only-managed -- uvx --python 3.11 mcp-for-blender

If it does not work

What you seeWhat to do
blender connects but every call failsThe addon is not running. Click Start MCP Server in Blender's sidebar tab.
You ran uvx mcp-for-blender in a terminal to "start" itDo not. Claude Code starts the server itself; a second copy only gets in the way.
First request errors, the next one worksA known quirk. If it persists, restart Claude Code and the Blender server.
Updated, and tools behave oddlyRun uvx mcp-for-blender@latest update, restart Blender and re-enable the addon.

MCP Shelf take

Is Blender MCP worth adding to Claude Code?

Claude Code is a natural home for Blender MCP if you also script Blender or build game assets: it can write a reusable Python tool for a task, run it in your scene, look at the result and adjust. The look tool is what makes it work, since the agent can check its own output instead of guessing. Save before every session, because it runs real code in your file. For one-off scene building, the installer gets you going in minutes; for anything you will repeat, ask Claude Code to save the script it wrote.

Sophie Filer

Questions

Do I need Claude Desktop for Blender MCP?

No. Claude Code works on its own with claude mcp add blender uvx mcp-for-blender. The installer can set up both if you use both.

Why does Blender MCP need an addon?

The MCP server talks to Blender through a small socket server that the addon runs inside Blender. Without the addon running, the tools have nothing to connect to.

Can I use Blender MCP with Blender on another computer?

Yes, by enabling remote connections in the addon and setting BLENDER_HOST and BLENDER_PORT. There is no authentication, so only do it on a trusted network, or use an SSH tunnel.

Sources: the steps on this page are written in our own words from Blender MCP's own install docs, the README. If they disagree with this page, the project's docs win; please tell us from the server page.