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.
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.
curl -LsSf https://www.mcp-for-blender.com/install.sh | shOn 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
- Step 1: Install uv with its official installer (
brew install uvon macOS,winget install --id=astral-sh.uv -eon Windows). - Step 2: Add the server to Claude Code with the command at the top of this page. Add
--scope userafteraddif you want it in every project. - Step 3: Install the addon:
uvx mcp-for-blender install-addon, then in Blender enable Interface: MCP for Blender under Edit, Preferences, Add-ons. - Step 4: In the 3D viewport press N, open the MCP for Blender tab and click Start MCP Server.
- Step 5: Start Claude Code, run
/mcpto 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:
| Tool | What it is for |
|---|---|
execute_blender_code | Run Python in your open Blender |
look | See the result from the viewport, the camera or several angles, in solid, material or rendered view |
get_scene_info | A compact summary of every object in the scene |
search_assets / import_asset | Pull models, textures and HDRIs from Poly Haven, Sketchfab and Poly Pizza |
generate_3d | Create 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:
claude mcp add blender -e UV_PYTHON_PREFERENCE=only-managed -- uvx --python 3.11 mcp-for-blenderIf it does not work
| What you see | What to do |
|---|---|
| blender connects but every call fails | The addon is not running. Click Start MCP Server in Blender's sidebar tab. |
You ran uvx mcp-for-blender in a terminal to "start" it | Do not. Claude Code starts the server itself; a second copy only gets in the way. |
| First request errors, the next one works | A known quirk. If it persists, restart Claude Code and the Blender server. |
| Updated, and tools behave oddly | Run 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.
