How To Connect Blender To Claude: Ultimate Simple Guide

Okay so you’ve seen the clips: someone types “make me a low-poly cabin in the woods” and Blender just… builds it. No modeling, no tutorials, no clicking through 47 menus. That’s Claude connected to Blender, and honestly, setting it up is way easier than people make it sound. This guide walks you through the whole thing step by step — and every step here has been tested on a real machine, so nothing in this article is theory.

What You Actually Need Before You Start

Let’s be real, half of these tutorials skip the requirements and you find out 20 minutes in that you’re missing something. Here’s the full list:

• Blender 3.0 or newer — free from blender.org
• Claude — either Claude Desktop (the app) or Claude Code (the terminal tool). Both work.
• uv — a small Python tool manager that runs the connection. Takes one command to install.

That’s it. You don’t need to know Python. You don’t need to be a developer. If you can copy and paste, you can do this.

How the Connection Actually Works

Quick 30-second explainer so the setup makes sense. The bridge between Claude and Blender is a free open-source project called blender-mcp, and it has two parts:

• A Blender addon — a small file you install inside Blender. It opens a private connection on your computer that listens for instructions.
• An MCP server — a tiny program that Claude talks to. MCP stands for Model Context Protocol, which is just the standard way Claude connects to outside apps.

Claude sends a request to the MCP server, the server passes it to the addon inside Blender, and Blender does the thing. Everything runs locally on your machine — nothing from your scene gets uploaded anywhere.

Step 1: Install uv

Open your terminal (on Mac: press Cmd + Space, type “Terminal”, hit enter) and paste this:

curl -LsSf https://astral.sh/uv/install.sh | sh

On Windows, open PowerShell and run:

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

Close and reopen your terminal after it finishes so it picks up the new command.

Step 2: Download the Blender Addon

Grab the addon file from the official blender-mcp GitHub repo. Easiest way is one terminal command:

curl -L -o ~/Downloads/blender_mcp_addon.py https://raw.githubusercontent.com/ahujasid/blender-mcp/main/addon.py

Or just go to github.com/ahujasid/blender-mcp, open addon.py, and save it to your Downloads folder. Either way works.

Step 3: Install the Addon in Blender

Now open Blender and:

1. Go to Edit → Preferences → Add-ons
2. Click Install (top right corner)
3. Select the blender_mcp_addon.py file you just downloaded
4. Tick the checkbox next to “Interface: Blender MCP” to enable it

That’s the Blender side done. It stays installed permanently, so you only ever do this once.

Step 4: Connect Claude to the Server

This step depends on which Claude you use, so pick your lane.

If You Use Claude Code (Terminal)

One command. Seriously, one:

claude mcp add blender -s user -- uvx blender-mcp

The -s user part makes it global, so the connection works in every project and folder on your computer, not just the one you’re standing in. Restart Claude Code after running it.

If You Use Claude Desktop (The App)

Go to Settings → Developer → Edit Config. That opens a file called claude_desktop_config.json. Add this to it:

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

Save the file and restart Claude Desktop. You’ll know it worked when you see a little tools icon in the chat box with Blender tools listed.

Step 5: Start the Connection Inside Blender

This is the step everyone forgets, and then they think the whole setup is broken. In Blender:

1. Hover over the 3D viewport and press N to open the sidebar
2. Click the BlenderMCP tab
3. Hit Connect to Claude

Heads up: you have to click that button every time you open Blender and want to use Claude with it. The addon stays installed forever, but the live connection starts fresh each session.

Step 6: Test It

Open Claude and try something like:

• “Create a low-poly scene of a cabin in the woods with trees around it”
• “What objects are currently in my Blender scene?”
• “Add a metallic red material to the cube”
• “Set up a three-point lighting rig around my model”

If Blender starts moving on its own, congratulations — you’re in. Claude can create and delete objects, apply materials, move the camera, run full Python scripts inside Blender, and inspect your scene to see what’s there before making changes.

Bonus: Free Assets and AI-Generated 3D Models

In that same BlenderMCP sidebar tab, there are two checkboxes worth knowing about:

• Poly Haven — lets Claude pull in free textures, HDRIs, and models from Poly Haven’s library. So you can say “texture the floor with wooden planks” and it actually fetches real textures.
• Hyper3D Rodin — lets Claude generate full 3D models from a text description using AI. It’s got a free tier, and it turns “make me a treasure chest” into an actual detailed model instead of a sad cube arrangement.

Troubleshooting: When It Doesn’t Work

Claude says it can’t connect to Blender. Nine times out of ten, you didn’t click “Connect to Claude” in the Blender sidebar (Step 5). Go click it.

The MCP server won’t start. Your terminal probably can’t find uv. Close and reopen the terminal, or reinstall it from Step 1.

Everything connects but commands do nothing. Make sure you only have ONE Claude session talking to Blender. Running Claude Desktop and Claude Code against it at the same time confuses the connection.

Something got half-built or broken. Claude runs real code in your scene, so treat it like a very fast intern: save your .blend file before asking for anything big. Blender’s undo still works, but a save is your real safety net.

Is This Actually Useful or Just a Party Trick?

Honest answer: both, and that’s fine. For experienced 3D artists, it’s a speed tool — blocking out scenes, batch-renaming objects, writing quick scripts without opening the code editor. For beginners, it’s genuinely the fastest way to learn Blender that has ever existed, because you can ask “how did you just do that?” and Claude explains the exact steps it took. And if you’re building content, courses, or a community around 3D and AI tools, this workflow is exactly the kind of thing people want to be shown — record your screen the first time you try it, because the reaction is the content.

Quick Recap

1. Install uv (one terminal command)
2. Download addon.py from the blender-mcp GitHub
3. Install and enable the addon in Blender’s preferences
4. Add the MCP server to Claude Code (claude mcp add blender -s user -- uvx blender-mcp) or Claude Desktop (config file)
5. Press N in Blender → BlenderMCP tab → Connect to Claude
6. Ask Claude to build something and watch it go

Total setup time is maybe ten minutes, and you only do it once. After that, connecting is a single click in the Blender sidebar. Have fun — and save your scenes.