Best for
- 3D artists and modelers who want to interact with Blender via natural language to boost productivity.
- Developers looking to integrate Blender into AI-driven workflows.
B
Blender MCP
Community
Open-source MCP server to connect Blender with any LLM for AI-assisted 3D modeling.
GitHub source repository ↗
59FMRS · C
BlenderMCP is a feature-rich open-source project that provides a powerful bridge for LLM-Blender interaction and is well-received by the community. Its highlights include multiple external resource integrations and bidirectional communication, but the arbitrary code execution poses security risks that users should use with caution.
BlenderMCP is an open-source project that connects Blender to Claude AI via the Model Context Protocol (MCP), enabling Claude to directly interact with and control Blender. It supports scene creation, object manipulation, material control, Python code execution, and more. The system consists of a Blender addon (addon.py) that serves as a socket server, and an MCP Python server. Tools include fetching scene/object info, creating/modifying/deleting objects, applying materials, executing arbitrary Python code, and integrating external resources like Sketchfab, Poly Haven, and Hyper3D. Installation requires Blender 3.0+, Python 3.10+, and the uv package manager.
Tools
Get Scene Info
Get detailed information about the current Blender scene.
Get Object Info
Get attributes of a specified object.
Create Object
Create a new 3D object in the scene.
Modify Object
Modify properties such as position, rotation, scale of an object.
Delete Object
Delete an object from the scene.
Apply Material
Apply an existing material to an object.
Create Material
Create a new material with properties like color.
Execute Blender Code
Execute arbitrary Python code in Blender (high risk).
Search Sketchfab
Search for 3D models on Sketchfab.
Download Sketchfab Model
Download a Sketchfab model into the Blender scene.
Load Poly Haven Asset
Load models, textures, or HDRIs from the Poly Haven API.
Generate Hyper3D Model
Generate 3D models via the Hyper3D Rodin API.
Generate Hunyuan3D Model
Generate 3D models via the Hunyuan3D API.
Capture Screenshot
Capture a screenshot of the Blender viewport to understand the scene.
Setup
- Install Blender 3.0 or later.
- Install Python 3.10+ and the uv package manager.
- Download the addon.py file from the repo, install and enable it in Blender via Edit > Preferences > Add-ons > Install...
- Add the MCP server configuration to Claude Desktop's claude_desktop_config.json, using uvx to run blender-mcp.
- In Blender, open the 3D View sidebar (press N), find the 'BlenderMCP' tab, and click 'Connect to Claude'.
- Ensure the MCP server is running in your client.
claude_desktop_config.json
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["--python", "3.11", "blender-mcp"],
"env": { "UV_PYTHON_PREFERENCE": "only-managed" }
}
}
}
Fit and risk
Not for
- Not suitable for automated environments that require strict security controls, as execute_blender_code allows arbitrary code execution.
- Not ideal for users needing reliable real-time rendering or complex animations, as tools focus on scene creation and modification.
Required permissions
- Network access to the Blender socket port (default 9876) for the MCP server.
- Ability to execute arbitrary Python code, which can access the file system and other system resources.
- External API keys (Sketchfab, Hyper3D, Hunyuan3D) for asset downloads and model generation.
Risks and side effects
- The execute_blender_code tool can run arbitrary code, potentially causing data loss or system damage. Always save your work before using it.
- Poly Haven integration may download large assets, consuming bandwidth and storage.
- When running remotely, network connectivity may expose the server.
- Third-party APIs may have usage limits or costs.
Troubleshooting
- Connection issues: Ensure the Blender addon is enabled and 'Connect to Claude' is clicked, the MCP server is configured on the client, and do not run uvx command manually in terminal.
- Timeout errors: Simplify requests or break them into smaller steps.
- PATH issues: Make sure the client can find the full path to uvx, or wrap with cmd /c.
- Python version conflicts: Use --python 3.11 and UV_PYTHON_PREFERENCE=only-managed.
- Restart both client and server: fully quit and relaunch.
Use cases
Ask Claude to create complex 3D scenes from text prompts, like 'Create a low poly dungeon scene with a dragon guarding a pot of gold'.
Generate Blender scenes from reference images.
Use Poly Haven assets (HDRIs, textures, models) to create a beach vibe.
Generate 3D models via Hyper3D or Hunyuan3D.
Modify materials and lighting in existing scenes.
Supported clients
Claude DesktopFull support