Blender MCP Server
Blender MCP Server connects Blender to Claude AI through the Model Context Protocol (MCP), enabling prompt-assisted 3D modeling, scene creation, and manipulation.
Overview
The Blender MCP Server connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. It is listed as a third-party MCP server in the official Model Context Protocol repository.
The system consists of two main components:
- Blender Addon (addon.py): A Blender addon that creates a socket server within Blender to receive and execute commands
- MCP Server (src/blender_mcp/server.py): A Python server that implements the Model Context Protocol and connects to the Blender addon
Key Features
Two-Way Communication
Connect Claude AI to Blender through a socket-based server
Object Manipulation
Create, modify, and delete 3D objects in Blender
Material Control
Apply and modify materials and colors
Scene Inspection
Get detailed information about the current Blender scene
Code Execution
Run arbitrary Python code in Blender from Claude
Asset Integration
Access Poly Haven assets and generate models with Hyper3D Rodin
Available Tools
Quick Reference
| Tool | Purpose | Category |
|---|---|---|
execute_blender_code | Run arbitrary Python code in Blender | Execution |
create_object | Create 3D objects in Blender | Manipulation |
modify_material | Apply or modify materials for objects | Material |
inspect_scene | Get detailed scene and object information | Inspection |
download_poly_haven_asset | Download assets from Poly Haven | Assets |
generate_hyper3d_model | Generate 3D models using Hyper3D Rodin | Generation |
Detailed Usage
execute_blender_code▶
Warning:
Use with caution in production environments as it allows running arbitrary code
Run arbitrary Python code in Blender from Claude.
use_mcp_tool({
server_name: "blender",
tool_name: "execute_blender_code",
arguments: {
code: "import bpy; bpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 0))"
}
});
create_object▶
Create 3D objects (e.g., cube, sphere) in the Blender scene.
use_mcp_tool({
server_name: "blender",
tool_name: "create_object",
arguments: {
type: "cube",
size: 2,
location: [0, 0, 0]
}
});
modify_material▶
Apply or modify materials and colors for Blender objects.
use_mcp_tool({
server_name: "blender",
tool_name: "modify_material",
arguments: {
object_name: "Cube",
material_name: "RedMaterial",
color: [1, 0, 0, 1]
}
});
inspect_scene▶
Get detailed information about the current Blender scene and objects.
use_mcp_tool({
server_name: "blender",
tool_name: "inspect_scene",
arguments: {}
});
Installation
Prerequisites
- Blender 3.0 or newer
- Python 3.10 or newer
- uv package manager (install via
brew install uvon macOS)
Claude Desktop Integration
Add the following configuration to claude_desktop_config.json:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}
Blender Addon Installation
- Download the
addon.pyfile from the GitHub repo - Open Blender > Edit > Preferences > Add-ons
- Install and enable the "Interface: Blender MCP" addon
Related Articles
Model Context Protocol (MCP): Open Standard for AI Integration
The Model Context Protocol (MCP) is an open standard enabling AI systems to connect with diverse data sources, tools, and services, eliminating custom integrations for seamless interaction.
Redis MCP Server
Redis MCP servers enable AI models to interact with Redis databases, providing capabilities for key-value operations, caching, pub/sub messaging, and high-performance data structures.
MCP Architecture Overview
MCP (Model Context Protocol) features a distributed architecture enabling AI applications to communicate seamlessly with multiple data sources and tools through standardized interfaces.