UNLIMITED Seedream 5.5 · Live on every paid plan

See how
Two orange 3D mannequins blocked in an empty studio, one pointing and one with folded arms
3D planning

Official BytePlus partnerBytePlus, a ByteDance company

How to set up Blender MCP with Claude Code

Step by step Blender MCP setup for Claude Code and Claude Desktop, from the project README read on 16 Nov 2026, plus a browser option with nothing to install.

KreatorFlow4 min read

Short answer

Install Blender, Python 3.10 or newer and the uv package manager. Add the server to Claude Code with the command claude mcp add blender uvx mcp-for-blender, install the Blender add-on with uvx mcp-for-blender install-addon, enable it in Blender's preferences, then connect from the add-on's tab in the sidebar. Steps are from the project README and Claude Code's setup page, read 16 Nov 2026. If you want no setup at all, use Stage in your browser.

Updated:

Set up Blender MCP in seven steps

  1. 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. 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. 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. 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. 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. 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. 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.

Frequently asked questions

How do I add Blender MCP to Claude Code?

Run claude mcp add blender uvx mcp-for-blender, install the Blender add-on with uvx mcp-for-blender install-addon, enable it in Blender and connect from its sidebar tab. Source: the project README, read 16 Nov 2026.

What do I need before I start?

Blender 3.0 or newer, Python 3.10 or newer, the uv package manager and an MCP client such as Claude Code or Claude Desktop.

Do I need a paid Claude plan?

Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account, and the free claude.ai plan does not include it (Claude Code setup page, read 16 Nov 2026).

Where is the connect button in Blender?

Press N in the 3D View, then open the MCP for Blender tab. The README names a connect button and a Start MCP Server button. Labels can differ between versions.

Can I run it with Cursor and Claude at the same time?

The README says to run only one MCP server instance, for example Cursor or Claude Desktop, not both.

Is there a way to build 3D scenes by chat with no setup?

Stage runs in your browser. It has limits, listed above. Making the video needs a paid plan; free accounts can plan, preview and export the previs.

Make a 3D scene by chat, nothing to install

Open Stage in your browser, tell Kiryu what you want and change it by chat. Building and exporting the 3D video cost no credits.

More guides