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
ArangoDB MCP Server
ArangoDB MCP servers enable AI models to interact with ArangoDB databases, providing capabilities for document operations, graph queries, AQL queries, and multi-model data management.
Ethereum RPC MCP Server
A TypeScript MCP server that exposes the full Ethereum JSON-RPC surface, enabling AI assistants to query on-chain data, inspect contracts, and retrieve transaction details across EVM networks. Includes optional analytics and Zircuit-specific SLS methods.
Ansible MCP Server
Ansible MCP servers enable AI models to interact with Ansible, providing capabilities for infrastructure automation, configuration management, and application deployment.