Keep going
Every workflow on Rundown University, free for 7 days
Members get all guides, courses, live sessions, and $1,000+ in partner perks.
Guides Blender published may 18, 2026
In this guide, you will learn how to connect Blender to Claude Code with MCP, then use plain English to create and edit a 3D scene.
You will connect Blender to Claude Code, confirm the MCP server is running, and test the connection by asking Claude to create a simple 3D name scene with disco balls and studio lighting.
You need:
You can also use the GitHub repo as a setup reference:
https://github.com/ahujasid/blender-mcpOnce the connection works, you can use Blender MCP for more than a quick name scene. Try using it to create thumbnail backgrounds, arrange product mockups, test animation ideas, or prepare 3D print concepts.
The best workflow is simple:
Blender is still the source of truth. Claude is the control layer. Use it to move faster, explore ideas, and make Blender less intimidating.
For polished results, treat Claude like a scene director. Give it real assets, then ask for lighting, camera, material, and composition changes.
Start by downloading Blender from blender.org: https://www.blender.org/. Blender is free and open source.
Install it like any other Mac app, then open it once before you start the MCP setup. The connection works best when Blender is already open and the MCP extension is running inside the app.
Open Blender's MCP Server page: https://www.blender.org/lab/mcp-server/. The page gives you two options: drag the extension into Blender or download it and install from disk.
The easiest route is drag and drop. Drag the MCP installer into Blender. If Blender asks you to add the Blender Lab repository first, allow it.
Pro tip: The drag-and-drop install can take two passes. The first pass adds the Blender Lab repository. The second pass installs the MCP add-on itself. If nothing appears after the first try, drag it in again or restart Blender and check Extensions.
Now open Edit -> Preferences. Search for MCP. You should see the MCP extension from Blender Lab.
Make sure the checkbox is enabled.
Expand the MCP extension details inside Blender Preferences. This is where the server settings live.
You should see settings like:
If the server does not start, check Blender's network setting. In our setup, Blender needed online access enabled before the MCP server would behave normally.
Pro tip: If Claude cannot connect, this screen is the first thing to check. It shows the exact host, port, file path, version, and whether the server is running. If you are stuck, screenshot this panel and paste it into Claude Code so it can reason from the real settings.
Open Terminal and start Claude Code in the project folder you want to use.
Then run:
claude mcp add blender -- uvx blender-mcp-server
claude mcp get blenderYou want Claude Code to show the blender MCP server as connected.
If you already added a Blender MCP server and it points to the wrong command, remove and re-add it:
claude mcp remove blender -s local
claude mcp add -s local blender -- uvx blender-mcp-server
claude mcp get blenderPro tip: The key is that Claude Code needs a working MCP config for the project you are in. If your mcp.json or Claude MCP config is wrong, Blender can be running perfectly and Claude still will not connect.
If the setup feels annoying, use Claude Code as the setup assistant. Paste the GitHub repo and ask it to verify the config.
Use this GitHub repo as a reference:
https://github.com/ahujasid/blender-mcp
Connect Claude Code to Blender and make sure my mcp.json or Claude MCP config is set up correctly. Check that Blender is running the MCP server, confirm the host and port, register `blender` if needed, and verify the connection before editing.This is useful because Claude can inspect your local MCP config, check whether the command is registered, and tell you what to fix. You still need to do the Blender GUI steps yourself: install the extension, enable it, and confirm the server is running.
There is also another setup option in the Claude desktop app. Open the directory, search for Blender under connectors, and add it there if it is available in your workspace.
This route can be easier if you prefer a UI, but the terminal route is still the cleanest way to verify the exact MCP command.
Once Claude Code shows Blender as connected, open Blender and try a small creative prompt.
Use Blender MCP to model my name in 3D. Add disco balls, dramatic lighting, reflective materials, and a camera angle that makes it look like an event poster.In the recording, the test prompt created large 3D letters for R and U. Earlier tests had Claude adding spheres and pyramids. The exact output will vary, but the important signal is that Blender changes in response to the prompt.
If the scene changes, the connection works.
Claude can create basic geometry from scratch, but it will often be better if you start with existing Blender assets.
For example, you can download models from:
Then ask Claude to arrange and improve the scene instead of inventing every object from scratch.
Use a prompt like:
Before creating anything from scratch, look for existing objects in this Blender scene and use those first.
Arrange the models into a clean hero composition. Improve the lighting, set a camera angle, adjust materials if needed, and prepare the scene for a still render.Pro tip: For polished results, treat Claude like a scene director. Give it real assets, then ask for lighting, camera, material, and composition changes. That usually works better than asking it to model every object from zero.
Keep going
Members get all guides, courses, live sessions, and $1,000+ in partner perks.