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
Flight Search MCP Server
Flight Search MCP server provides real-time flight data, airline schedules, airport information, and route planning capabilities for AI-powered travel assistance.
Integration and Automation MCP Servers
The Integration & Automation category provides integration with automation tools and workflow systems, enabling seamless connectivity and process automation across different platforms and services.
arXiv MCP Server
arXiv MCP server provides AI assistants with access to over 2 million academic papers across physics, mathematics, computer science, and related fields through the arXiv API.