blender-mcp

blender-mcp (via mcp2cli)

Control Blender and import 3D assets via CLI.

Shortcuts

• mcp2cli blender <cmd> (alias for mcp2cli 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.