blenderwright
MCP server for Blender. Hundreds of tools for modeling, materials, rendering and more over a signed local socket, raw Python off by default. Works with Claude,
What is blenderwright?
MCP server for Blender. Hundreds of tools for modeling, materials, rendering and more over a signed local socket, raw Python off by default. Works with Claude, Cursor, Codex, Ollama, llama.cpp, or any MCP client.
Overview of blenderwright
What it is
blenderwright is an MCP server for Blender that provides 276 tools across 32 modules. It allows AI assistants such as Claude, Cursor, Codex, Ollama, and llama.cpp to control Blender through natural language. The server includes expert prompts, a visual feedback loop, and mesh quality analysis to guide the LLM toward professional 3D results. It was formerly named blend-ai.
Key features
- 276 tools across 32 modules covering modeling, mesh editing, materials, shader nodes, lighting, camera, animation, rendering, sculpting, UV mapping, physics, geometry nodes, rigging, curves, sweeps along a path, 3D-print checking, annotations, collections, file I/O, Bool Tool, viewport control, mesh quality analysis, and extension suggestions - 13 expert prompts including topology best practices, real-world scale references, lighting principles, studio setup, character basemesh workflow, PBR material guide, and auto-critique feedback loop - Visual feedback loop: fast viewport screenshots via OpenGL render (~ms) with auto-critique prompts that guide the LLM to check its own work - Mesh quality analysis: structured reports covering non-manifold edges, loose vertices, zero-area faces, duplicate vertices, and wire edges - Extension suggestions: proactively recommends Bool Tool, LoopTools, and Node Wrangler when a task would benefit from them (skips already-installed extensions)
- Render-aware: automatically detects when Blender is rendering and queues commands; recovers from stuck render guards via load_post handler and reset command - Zero telemetry, zero-dependency addon (uses only Python stdlib + bpy), thread-safe architecture with background TCP server, and 3500+ tests
Use cases
- Creating 3D models from natural language descriptions, such as a Western saloon or a space shuttle launch scene - Setting up scenes, materials, lighting, and animation entirely through AI assistants - Rendering animations (e.g., 60 Cycles frames from a single render_animation call)
- Analyzing mesh quality and fixing issues like non-manifold edges or duplicate vertices - Generating procedural materials with a single create_procedural_material call
Getting started
Install the MCP server: bash uvx blenderwright Or with pip: bash pip install blenderwright Install the Blender addon: 1. Download the latest addon zip from GitHub Releases 2. Open Blender 5.2 LTS 3. Go to Edit > Preferences > Get Extensions, click the dropdown (▾) top-right, and choose Install from Disk... 4. Select the downloaded .zip file 5. Enable blenderwright in the extensions list Start the server in Blender's N-panel (press N, find the blenderwright tab, set port, click Start Server). Connect your AI assistant (example for Claude Code): bash claude mcp add blenderwright -- uvx blenderwright
License and pricing
The project is licensed under MIT and is open source.
Based on the project's public README and repository metadata.