UNLIMITED Seedream 5.5 · Live on every paid plan

See how
An open desktop PC case on a workbench with a large graphics card and memory sticks beside it
3D planning

Official BytePlus partnerBytePlus, a ByteDance company

Blender MCP not working? Common fixes

Blender MCP will not connect, times out or freezes? The fixes the project README lists, read on 16 Nov 2026, and a browser option when you would rather skip MCP.

KreatorFlow3 min read

Short answer

Most Blender MCP problems come from the add-on server not running, the MCP server not being set up in your AI client, two clients running at once, or a request that is too big. Check that the server is started in Blender's sidebar, restart both the AI client and the Blender server, and split big requests into smaller steps. Fixes below are only the ones the project README lists, read 16 Nov 2026.

Updated:

Work through this in order

  1. 1

    Check the Blender server is running

    In Blender press N, open the MCP for Blender tab and make sure the server is started. Use Start MCP Server if it is not.

  2. 2

    Check the MCP server is set up in your AI client

    Claude Code, Claude Desktop or Cursor must have the blender entry from the setup steps.

  3. 3

    Do not start the server yourself in a terminal

    The README says not to run uvx in the terminal by hand. The AI client starts it.

  4. 4

    Try the request again

    The README says the first command may fail and later ones often work.

  5. 5

    Restart both sides

    Restart your AI client and the Blender server. The README lists this as the fix for connection errors that stay.

  6. 6

    Run one MCP server only

    Do not have Cursor and Claude Desktop both running the server at the same time.

Before you retry

The README warns that the execute_blender_code tool can run arbitrary Python in Blender and says to always save your work first. Save before every retry, especially after a freeze.

Still stuck?

If none of this helps, the project's GitHub page is the place for version-specific problems. Nothing here is a guarantee: these are the documented fixes only, read 16 Nov 2026. Blender and Claude are trademarks of their owners. KreatorFlow is not affiliated with either, and Blender MCP is a third-party project.

Skip MCP: build the scene in your browser

If you only wanted a 3D scene or a short 3D video, you can skip the add-on, the server and the client. Open Stage, tell Kiryu what you want and change it by chat. Nothing to install, and you can start without an account.

Stage has limits: scenes come from menus of sets, props, characters, creatures and moves, there is no free modelling or sculpting, and it renders in real time. For custom models and final renders, keep Blender.

Specific problems the README names

Source: the project README, read 16 Nov 2026. Projects change, so check the README for your version.

Timeout errors

Simplify the request or split it into smaller steps.

Source: Blender MCP README on GitHub (read 16 Nov 2026)

Blender freezes during a Poly Haven download

Poly Haven downloads run on Blender's main thread, so the window can freeze until they finish. Ask for lower resolutions, such as 1k or 2k, when you can.

Source: Blender MCP README on GitHub (read 16 Nov 2026)

A Poly Pizza download fails with a Cloudflare challenge

The README says the CDN blocks datacenter, VPN and cloud addresses. Retry from a normal connection, or import the .glb file by hand.

Source: Blender MCP README on GitHub (read 16 Nov 2026)

Hunyuan3D works for some accounts and fails for others

The README says mainland Tencent Cloud accounts use the default endpoint, while international accounts need the International (Pro) account toggle. International credentials sent to the mainland endpoint fail.

Source: Blender MCP README on GitHub (read 16 Nov 2026)

On Windows with Cursor, the server will not start

The README uses the command cmd with the arguments /c, uvx and mcp-for-blender for Cursor on Windows.

Source: Blender MCP README on GitHub (read 16 Nov 2026)

My old blender-mcp setup stopped matching the docs

The README says the project was renamed and the package is now mcp-for-blender. It also says existing uvx blender-mcp setups still work.

Source: Blender MCP README on GitHub (read 16 Nov 2026)

Frequently asked questions

Why is Blender MCP not connecting?

Make sure the add-on server is started in Blender's sidebar and that the MCP server is set up in your AI client. Do not run uvx in the terminal yourself. Then restart both the client and the Blender server. Source: the project README.

Why do I get timeout errors?

The README advises simplifying the request or splitting it into smaller steps.

Why does Blender freeze?

Poly Haven downloads block Blender's main thread until they finish. Ask for lower resolutions.

The first command failed. Is something broken?

The README says the first command may fail and later ones often work, so try again before changing anything.

Can I run it in Cursor and Claude Desktop together?

No. The README says to run only one MCP server instance at a time.

Is there something without a setup to break?

Stage builds 3D scenes by chat in your browser with nothing to install. It is not a Blender replacement. 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