blenderwright MCP

MCP server and addon for Blender 5.2: 276 tools for modeling, materials, animation and rendering with mesh quality checks

  • 196 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • The tools create, delete and change scene objects and read and write files through import and export
  • The "Allow raw Python" mode opens arbitrary code execution inside Blender, although it is off by default
All reasons and checks

holdmybeer-gg/blenderwright

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/blenderwright

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The tools create, delete and change scene objects and read and write files through import and export
  • The "Allow raw Python" mode opens arbitrary code execution inside Blender, although it is off by default

This is third-party code. Review the repository files before installing.

What it does

blenderwright has two parts: an MCP server in Python and a Blender addon. The addon starts a local TCP server inside Blender, on port 9876 by default, and the MCP server forwards the agent's commands to it. There are 276 tools in 32 modules: primitives and modifiers, mesh editing, materials and shader nodes, lighting, camera, animation, rendering, sculpting, UV unwrapping, physics, geometry nodes, rigging, curves and file import and export. The project also teaches the model to make clean geometry. Thirteen ready prompts cover topology, real-world scale, lighting setups, PBR materials and a self-critique loop built on viewport screenshots. A mesh quality report finds non-manifold edges, loose vertices and zero-area faces. Viewport screenshots go through OpenGL in milliseconds. Arbitrary Python stays off until you tick "Allow raw Python" in the N panel yourself. The permission lasts for the session and is never saved into the `.blend`. The server installs with `uvx blenderwright` and the addon from a release file.

Who it is for. 3D artists and game developers on Blender 5.2 LTS who want Claude Code or Claude Desktop to create objects, scenes, materials and renders.

Good fit when

  • A two-storey saloon scene is built from scratch from one sentence and then relit for dusk
  • A model from a scan or an outside source is cleaned: defect analysis, repair, decimation, normals and scale
  • A product turntable is shot automatically: studio light, camera and render into a folder
  • A procedural material is assembled by one `create_procedural_material` call with its nodes and links
  • A scene for printing is checked for reversed normals and thin walls through the 3D Print Toolbox

Not a fit when

  • Blender 5.1 or older is installed: the addon refuses to install on those versions
  • You need work without a running Blender: the tools drive an open window through a local server
  • The model is small and context is tight: the full set of schemas takes about 48 thousand tokens per request
  • You need another 3D package such as Maya or Unity: blenderwright targets only Blender

Example request

Create a red metallic sphere on a white plane with three-point lighting and render it

MCP

Transport
stdio
Authentication
not required

Environment variables

BLENDERWRIGHT_TOOLSETS
Which tool groups to load: `all`, `auto` or `core`.

Limitations

  • Only Blender 5.2 LTS is supported. The addon does not install on 5.1 and older.
  • The MCP server and the addon must come from the same release: a protocol mismatch is refused with an error. After an addon update you restart Blender fully, since reloading scripts is not enough.
  • All tools load by default and the schemas take about 48 thousand tokens per request. The `BLENDERWRIGHT_TOOLSETS` variable with `core` or `auto` trims the set.
  • During a render, commands wait in a queue.

How to disable. Click Stop Server on the blenderwright tab of the N panel and delete the server entry from your client config, for example with `claude mcp remove blenderwright`. Remove the addon with Uninstall under Preferences, Get Extensions tab.

FAQ

How do I connect blenderwright to Claude Code?

Run `claude mcp add blenderwright -- uvx blenderwright`, then in Blender 5.2 install the addon from releases through Install from Disk and click Start Server on the blenderwright tab of the N panel. Blender has to be running before the first call.

Can the agent run arbitrary code in Blender?

Only with your permission. The `execute_blender_code` tool is off until you tick "Allow raw Python" in the N panel. Every snippet is echoed to the console and listed in the panel, and a restricted namespace blocks obvious mistakes such as importing `os`.

How is blenderwright different from blend-ai?

It is not: that was the project's earlier name. The author renamed it and nothing else changed.

How do I avoid spending many tokens on tool schemas?

Set the `BLENDERWRIGHT_TOOLSETS` variable or the `--tools` flag. The `core` value keeps the main groups, and `auto` adds `list_toolsets` and `enable_toolset` so the model loads the rest as a task needs.

Does blenderwright collect user data?

No. The author states zero telemetry: no tracking or analytics, and everything runs locally on `127.0.0.1`.

Discussion

No questions or reviews yet.

Blender MCP

MCP for Blender

Editors’ pick

An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender

MCP serverBroad access34.1KRepository stars

An enhanced Blender MCP build: work with a live Blender and with saved .blend files without a UI, runtime bpy API lookup and the BlenderBench test suite

MCP serverBroad access97Repository stars

Blender MCP: an agent in Cursor, Cline, Windsurf or Claude Desktop builds and edits 3D scenes in Blender from a description; the server installs with uvx

MCP serverExtended access301Repository stars

A small Node.js Blender MCP: a stdio server sends Python code to Blender over TCP, reads the scene and pulls Poly Haven assets

MCP serverBroad access99Repository stars

Thirty chained skills drive Blender through MCP: modeling, materials, lighting, camera, rendering, animation and glTF export

SkillBroad access159Repository stars

Blender Agent Studio builds models and scenes in Blender from a description: a .blend file, Python source and checked renders.

PluginExtended access111Repository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
blenderwright (this card)nonot required196
Blender MCPnonot required34,097a server and addon for Blender with Python execution, while blenderwright adds hundreds of ready tools, prompts and mesh checks
Blender MCP (VxAI)nonot required301a separate Blender MCP implementation, while blenderwright targets Blender 5.2 with a set of 276 tools

README in short

The page shows a shuttle launch animation and a saloon built from single requests, then lists features, a quick install of the server and addon, updating both halves and connecting clients. It continues with tables of the 13 prompts and 32 tool modules and a description of toolsets that save tokens.

README badge

Report a problem