dcc-mcp-blender
An agent inside a live Blender scene with over 200 typed tools for meshes, UVs, materials, rigging and rendering
- 62 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The `execute_python` and `execute_script_file` tools run arbitrary code inside Blender, and the server edits scenes and project files.
Install
- Works in
Manual install
codex plugin marketplace add dcc-mcp/dcc-mcp-agent-pluginsThe first README command adds the DCC-MCP agent plugin for Codex, then `codex plugin add dcc-mcp@dcc-mcp`. The Blender add-on itself installs from a release ZIP or `pip install dcc-mcp-blender`.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The `execute_python` and `execute_script_file` tools run arbitrary code inside Blender, and the server edits scenes and project files.
This is third-party code. Review the repository files before installing.
What it does
`dcc-mcp-blender` embeds an MCP server inside the Blender process. Once the add-on is enabled, any MCP client calls tools over HTTP: primitive creation, face extrusion, bevels, boolean operations, UV unwrapping, material assignment, geometry nodes, animation, rigging, cameras and rendering. The README claims more than 200 ready tools grouped into over 25 skills. It installs as a Blender extension (a ZIP from the releases, Blender 4.5 or newer) or as a `pip` package. An agent can also read `install.md` and set up the dependencies itself. Service groups cover add-on development, scripting and running checks.
Who it is for. 3D artists and technical artists who want to drive a Blender scene with text commands and keep the result editable.
Good fit when
- Scene must be built from primitives with bevels and booleans from a description
- A model needs UV unwrapping and a checker pass to verify texture coordinates
- Material and lighting are tuned in a live session and the render is reviewed at once
- A Blender add-on is written and debugged while the agent reloads modules and runs checks
Not a fit when
- Your Blender is older than 4.5, since the adapter rejects such builds at install time
- An agent must not execute arbitrary code inside the Blender process
- A one-off scene edit does not justify setting up an add-on and a server
Example request
Inspect the Blender scene, list its objects and propose a plan: read-only first, edits after my confirmation.MCP
- Transport
- http
- Authentication
- not required
Environment variables
DCC_MCP_BLENDER_DISABLE_EXECUTE_PYTHON- Set to true to disable the `execute_python` and `execute_script_file` tools
Limitations
Blender 4.5 is the minimum; the author tested 4.5 LTS and 5.2 on Windows, Linux and macOS. Install through the Extensions menu, because the old Add-ons tab path does not work. Background tests do not prove GUI or GPU behavior, and gaps are listed in the coverage document. The `execute_python` and `execute_script_file` tools run arbitrary code in Blender; the `DCC_MCP_BLENDER_DISABLE_EXECUTE_PYTHON` variable turns them off. UI control needs a separate `dcc-cua`.
How to disable. Disable the extension in Blender preferences and remove the `blender` entry from the MCP client configuration. A `pip` install is removed with `pip uninstall dcc-mcp-blender`.
FAQ
How do I connect a client?
Add an entry with the address `http://127.0.0.1:9765/mcp` to the MCP client configuration, as in the README example for Claude Desktop. The server picks the port at start, so check it against the `dcc-mcp-cli list` output.
Which Blender version is needed?
Blender 4.5 or newer. The adapter rejects older builds at install time, and CI runs 4.5 LTS and 5.2.
How do I block arbitrary code execution?
Set `DCC_MCP_BLENDER_DISABLE_EXECUTE_PYTHON=true` to disable `execute_python` and `execute_script_file`. The `DCC_MCP_BLENDER_DISABLE_ARBITRARY_SCRIPT` variable closes every arbitrary script path.
How does it differ from `mcp-for-blender`?
Here the server runs inside Blender with no external process and exposes typed tools. `mcp-for-blender` relays over a socket and runs arbitrary Python by default.
Can I install with pip?
Yes, `pip install dcc-mcp-blender`, then call `dcc_mcp_blender.start_server()` in Blender's Python console. The README recommends the extension for everyday use.
Discussion
No questions or reviews yet.
Related
MCP serversBlender MCP
MCP for Blender
An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender
MCP server and addon for Blender 5.2: 276 tools for modeling, materials, animation and rendering with mesh quality checks
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
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
A small Node.js Blender MCP: a stdio server sends Python code to Blender over TCP, reads the scene and pulls Poly Haven assets
An Autodesk Maya MCP adapter: an agent inspects the scene, builds geometry and edits materials and animation through typed tools.
README in short
The README covers extension and package installs, client connection, tools by group, environment variables and a comparison with `mcp-for-blender`. Separate showcases include a crate with PBR materials and a stylized reconstruction from a reference.