makabakaxy blender-mcp (via mcp2cli)
Control Blender and import 3D assets via CLI.
Shortcuts
mcp2cli blender <cmd>(alias formcp2cli blender-mcp)
Commands
Scene
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli blender scene get |
Get current scene info | mcp2cli blender scene get --user-prompt 'show scene' |
ref |
mcp2cli blender scene object get |
Get object details | mcp2cli blender scene object get --object-name Cube |
ref |
mcp2cli blender scene viewport screenshot |
Capture viewport screenshot | mcp2cli blender scene viewport screenshot --max-size 1200 |
ref |
Code
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli blender code execute |
Execute Python code in Blender | mcp2cli blender code execute --code 'bpy.ops.mesh.primitive_cube_add()' |
ref |
PolyHaven
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli blender polyhaven asset search |
Search PolyHaven assets | mcp2cli blender polyhaven asset search --asset-type textures |
ref |
mcp2cli blender polyhaven asset download |
Download and import asset | mcp2cli blender polyhaven asset download --asset-id venice-sunset --asset-type hdris --resolution 2k |
ref |
mcp2cli blender polyhaven texture set |
Apply texture to object | mcp2cli blender polyhaven texture set --object-name Cube --texture-id wood-plank |
ref |
mcp2cli blender polyhaven category list |
List asset categories | mcp2cli blender polyhaven category list --asset-type textures |
ref |
Sketchfab
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli blender sketchfab model search |
Search Sketchfab models | mcp2cli blender sketchfab model search --query 'wooden chair' |
ref |
mcp2cli blender sketchfab model preview |
Preview model thumbnail | mcp2cli blender sketchfab model preview --uid abc123 |
ref |
mcp2cli blender sketchfab model download |
Download and import model | mcp2cli blender sketchfab model download --uid abc123 --target-size 1.0 |
ref |
Hyper3D
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli blender hyper3d model generate-from-text |
Generate 3D model from text | mcp2cli blender hyper3d model generate-from-text --text-prompt 'a wooden barrel' |
ref |
mcp2cli blender hyper3d model generate-from-images |
Generate 3D model from images | ref | |
mcp2cli blender hyper3d model import |
Import generated Hyper3D asset | mcp2cli blender hyper3d model import --name MyModel --task-uuid abc123 |
ref |
mcp2cli blender hyper3d job poll |
Poll Hyper3D job status | ref |
Hunyuan3D
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli blender hunyuan3d model generate |
Generate 3D model (text/image) | mcp2cli blender hunyuan3d model generate --text-prompt 'a ceramic vase' |
ref |
mcp2cli blender hunyuan3d model import |
Import generated Hunyuan3D asset | mcp2cli blender hunyuan3d model import --name MyModel --zip-file-url /path/model.zip |
ref |
mcp2cli blender hunyuan3d job poll |
Poll Hunyuan3D job status | ref |
Discover Parameters
Append --help to any command for full parameter list:
mcp2cli blender code execute --help
Note: Use Ref links above to view detailed parameter reference and more examples.
User Notes
MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in
~/.agents/mcp2cli/servers.yaml- edit there to take effect.