BlenderMCP Setup Guide

What you need

1. 1

   Step 1

   Install uv

   uv is the package manager that runs BlenderMCP. Open your terminal and run:

   🍎

   macOS

   TerminalCopy

   brew install uv

   🪟

   Windows

   TerminalCopy

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

   Then add uv to your PATH:

   TerminalCopy

   $localBin = "$env:USERPROFILE\.local\bin"
   $userPath = [Environment]::GetEnvironmentVariable("Path", "User")
   [Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

   Restart Claude Desktop after this step.

   Mark as done
2. 2

   Step 2

   Install the Blender addon

   1. Go to the BlenderMCP GitHub repo
   2. Download the addon.py file
   3. Open Blender
   4. Go to Edit > Preferences > Add-ons
   5. Click Install... and select addon.py
   6. Enable "Interface: Blender MCP" by checking the box

   Mark as done
3. 3

   Step 3

   Connect Claude to Blender

   💬

   Claude Desktop

   Open Claude > Settings > Developer > Edit Config.

   Add this to your claude_desktop_config.json:

   jsonCopy

   {
     "mcpServers": {
       "blender": {
         "command": "uvx",
         "args": ["blender-mcp"]
       }
     }
   }

   ⚡

   Claude Code (terminal)

   Just run:

   TerminalCopy

   claude mcp add blender uvx blender-mcp

   Done.

   Mark as done
4. 4

   Step 4

   Start the connection

   1. Open Blender
   2. Press N to open the sidebar
   3. Find the BlenderMCP tab
   4. (Optional) Enable Poly Haven for free 3D assets and HDRIs
   5. Click Connect to Claude

   That's it. Claude can now control Blender.

   Mark as done

What to try first

Create a sphere with a metallic red material and place it on a wooden table

Build a low-poly dungeon scene with a dragon guarding gold

Point the camera at the scene and make it isometric

Download a beach HDRI from Poly Haven and apply it as the background

Troubleshooting