Blender Features
- •Two-way communication between Claude AI and Blender
- •Object manipulation (create, modify, delete 3D objects)
- •Material control (apply and modify materials and colors)
- •Scene inspection (get detailed information about the current scene)
- •Code execution (run arbitrary Python code in Blender)
- •Poly Haven asset integration (HDRIs, textures, models)
Blender Setup & Configuration
Requirements
- •Blender 3.0 or newer
- •Python 3.10 or newer
- •uv package manager
- •Claude Desktop or Cursor
Installation Instructions
# UV Installation
uvx blender-mcp
# Installing the Blender Addon
1. Download the addon.py file from the repository
2. Open Blender
3. Go to Edit > Preferences > Add-ons
4. Click "Install..." and select the addon.py file
5. Enable the addon by checking the box next to "Interface: Blender MCP"
Configuration
# Claude Desktop Configuration
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}
# Cursor Integration
Run blender-mcp without installing it permanently through uvx. Go to Cursor Settings > MCP and paste this as a command:
uvx blender-mcp
Blender Available Tools
- •
get_scene_info
- •
get_object_info
- •
create_primitive
- •
set_object_property
- •
create_object
- •
modify_object
- •
delete_object
- •
set_material
- •
execute_blender_code
- •
get_polyhaven_categories
- •
search_polyhaven_assets
- •
download_polyhaven_asset
Blender Required Inputs
Poly Haven Integration
- Type
- boolean
- Description
- Enable Poly Haven asset integration (optional)
- Required
- No
Blender Use Cases
- •AI-assisted 3D modeling and scene creation
- •Low-poly scene generation from text descriptions
- •Material and lighting setup
- •Converting reference images to 3D scenes
- •Automating repetitive modeling tasks
- •Importing assets from Poly Haven
- •Exporting scenes for web (ThreeJS) or other platforms
Frequently Asked Questions
BlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.
Blender 3.0 or newer, Python 3.10 or newer, uv package manager, Claude Desktop or CursorView detailed requirements
Follow the installation instructions in the setup section above.View installation guide
Blender MCP provides the following tools:
- •
get_scene_info
- •
get_object_info
- •
create_primitive
- •
set_object_property
- •
create_object
- •
modify_object
- •
delete_object
- •
set_material
- •
execute_blender_code
- •
get_polyhaven_categories
- •
search_polyhaven_assets
- •
download_polyhaven_asset