Blender MCP
by ahujasid
Prompt-assisted 3D modeling — connect Blender to AI through MCP for scene creation and manipulation
design Python Intermediate Self-hostable No API key Featured
⭐ 17.4k stars 📅 Updated: 1mo ago
Description
Blender MCP integrates Blender with Claude AI and other LLMs through the Model Context Protocol, enabling prompt-assisted 3D modeling, scene creation, and manipulation. Uses two-way socket communication between the MCP server and a Blender addon to provide real-time control over 3D scenes. Supports creating and modifying objects with precise positioning, applying materials and textures, inspecting scene hierarchies, and executing arbitrary Python code inside Blender. Extends beyond basic modeling with Poly Haven asset integration for high-quality HDRIs, textures, and models, Hyper3D Rodin AI-powered 3D model generation from text or images, and Sketchfab model search and download. The screenshot capability lets the AI see and iterate on the 3D scene visually.
✅ Best for
3D artists and developers who want to accelerate Blender workflows with AI-driven scene creation
⏭️ Skip if
You need production-quality rendering pipelines — this is for modeling and scene setup, not final render management
💡 Use cases
- Creating 3D scenes and objects through natural language prompts
- Rapid prototyping of 3D models and environments with AI assistance
- Applying materials, textures, and lighting setups via conversational instructions
- Downloading and composing assets from Poly Haven and Sketchfab into scenes
👍 Pros
- ✓ No API key required — works entirely locally with Blender
- ✓ Rich integration with Poly Haven, Hyper3D Rodin, and Sketchfab asset libraries
- ✓ Two-way communication allows the AI to see screenshots and iterate on designs
- ✓ Supports executing arbitrary Python inside Blender for advanced customization
👎 Cons
- ✗ Requires Blender installed with the companion addon — not a standalone tool
- ✗ Complex scenes with many objects may produce large context for the AI
- ✗ 3D modeling results depend heavily on prompt quality and iteration
🔧 Exposed tools (9 tools)
| Tool | Category | Description |
|---|---|---|
| download_asset | assets | Download assets from Poly Haven (HDRIs, textures, models) |
| search_sketchfab | assets | Search and download 3D models from Sketchfab |
| generate_3d_model | generation | Generate a 3D model using Hyper3D Rodin from text or image input |
| apply_material | materials | Apply materials and textures to objects in the scene |
| create_object | modeling | Create a new 3D object in the Blender scene |
| modify_object | modeling | Modify properties of an existing object (position, scale, rotation) |
| inspect_scene | observation | Get a structured overview of all objects in the current scene |
| take_screenshot | observation | Capture a screenshot of the current Blender viewport |
| execute_python | scripting | Execute arbitrary Python code inside Blender's scripting environment |
⚡ Installation
Prerequisites:
- • python v3.10+
- • Blender 3.0+ with the Blender MCP addon installed
- • uvx for running the MCP server
Check Claude Code documentation to configure this MCP server.
💡 Tips & tricks
Install the Blender addon first, then start the MCP server with uvx blender-mcp. Use the take_screenshot tool frequently to let the AI see the current state of your scene and make corrections. Combine with Poly Haven assets for quick professional-looking results.
Quick info
- Author
- ahujasid
- License
- MIT
- Runtime
- Python 3.10+
- Transport
- stdio
- Category
- design
- Difficulty
- Intermediate
- Self-hostable
- ✅
- Auth
- —
- Docker
- —
- Version
- latest
- Updated
- Feb 28, 2026
Client compatibility
- ✅ Claude Code
- ✅ Cursor
- ❓ VS Code Copilot
- ❓ Gemini CLI
- ❓ Windsurf
- ❓ Cline
- ❓ JetBrains AI
- ❓ Warp
Platforms
🍎 macOS 🐧 Linux 🪟 Windows