Get started
Set up Blender MCP in seven steps
- 1
Install the prerequisites
You need Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. Install uv with its official installer. The README warns against installing it with pip.
- 2
Get Claude Code
Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account. The free claude.ai plan does not include it. Install it with the command for your system on the Claude Code setup page, then run claude and log in.
- 3
Quick option: run the setup command
The README offers uvx mcp-for-blender setup. It installs uv, configures MCP clients it detects, and installs and enables the add-on. If it works, skip to step 6.
- 4
Or add the server by hand
For Claude Code, run the command in the box below. For Claude Desktop, open Settings, Developer, Edit Config and add a blender entry under mcpServers with the command uvx and the argument mcp-for-blender.
- 5
Install the add-on
Run uvx mcp-for-blender install-addon. In Blender open Edit, Preferences, Add-ons and enable Interface: MCP for Blender. If it does not appear, use Install and pick the copied file, or restart Blender.
- 6
Connect from Blender
In the 3D View press N to open the sidebar and open the MCP for Blender tab. Click the connect button, or Start MCP Server if the server is not running. Button names can differ between versions. Run only one MCP server instance at a time.
- 7
Test it with a small request
Ask Claude to describe the scene or add one cube. Save your work first: the tool can run any Python in Blender.
The Claude Code command
From the project README, read 16 Nov 2026. Run it in a terminal.
Add Blender MCP to Claude Code
claude mcp add blender uvx mcp-for-blender
The add-on command
Run this once, then enable the add-on inside Blender as in step 5.
Install the Blender add-on
uvx mcp-for-blender install-addon
Cursor and other clients
The README gives the same blender entry for Cursor, in Settings, MCP, or in .cursor/mcp.json for one project. On Windows it uses the command cmd with the arguments /c, uvx and mcp-for-blender. Do not run the server from two clients at once.
Optional asset and 3D generation services
Poly Haven needs no key. Sketchfab, Hyper3D and Hunyuan3D need their own keys or accounts, set up as the README describes. Skip them until the basic connection works.
A note on names
The README says the project was formerly called blender-mcp and its package is now mcp-for-blender, and that existing uvx blender-mcp setups still work. Guides written before the change may use the old name. Blender and Claude are trademarks of their owners. KreatorFlow is not affiliated with either, and Blender MCP is a third-party project.
Sources
Every step above comes from these two pages, read on 16 Nov 2026. Projects change, so check them for your version.
The no-setup option: Stage
If you only want a 3D scene or a short 3D video, skip all of the above. Open Stage in your browser, tell Kiryu what you want and change it by chat. There is nothing to install and no account is needed to start. Building and exporting the 3D video cost no credits.
Stage is not Blender. It builds scenes from menus of sets, props, characters, creatures and moves, with no free modelling, sculpting, UV work or node materials, and it renders in real time. If you need those, the setup above is the way.



