Blender MCP Capabilities: What You Can Build

Blender MCP gives your AI client a toolkit of actions in Blender, from reading scene state to downloading production-ready assets.

Capability Overview

Scene Inspection

Read the full scene graph, object lists, transforms, and collections in real time.

Object Manipulation

Create, move, rotate, scale, rename, and delete objects using natural language prompts.

Material Control

Assign and configure materials, textures, and shaders on any object in the scene.

Code Execution

Run arbitrary Blender Python (bpy) for operations not covered by built-in tools.

Asset Integration

Search and download HDRIs, textures, and 3D models from Poly Haven, Sketchfab, Poly Pizza, Hyper3D, and Hunyuan3D.

Viewport Screenshots

Capture the current 3D viewport and return it to the AI client for visual feedback.

Full Tool Reference

Tool	Category	What It Does
`get_scene_info`	Scene	Returns the full scene graph, objects, and collections.
`get_object_info`	Scene	Returns detailed data for a specific object by name.
`get_viewport_screenshot`	Viewport	Captures the current 3D viewport as an image.
`execute_blender_code`	Code	Runs arbitrary Python in Blender and returns the result.
`get_polyhaven_status`	Asset	Checks whether Poly Haven integration is enabled and reachable.
`search_polyhaven_assets`	Asset	Searches Poly Haven for HDRIs, textures, or models.
`download_polyhaven_asset`	Asset	Downloads and imports a Poly Haven asset into the scene.
`set_texture`	Material	Applies a texture or material to the selected object.
`search_sketchfab_models`	Asset	Searches Sketchfab for downloadable 3D models.
`download_sketchfab_model`	Asset	Downloads and imports a Sketchfab model into the scene.
`search_polypizza_models`	Asset	Searches Poly Pizza for low-poly 3D models.
`download_polypizza_model`	Asset	Downloads and imports a Poly Pizza model into the scene.
`generate_hyper3d_model_via_text`	AI	Generates a 3D model from a text prompt using Hyper3D Rodin.
`generate_hyper3d_model_via_images`	AI	Generates a 3D model from one or more images using Hyper3D Rodin.
`poll_rodin_job_status`	AI	Checks the generation status of a Hyper3D Rodin job.
`import_generated_asset`	AI	Imports a completed Hyper3D Rodin model into Blender.
`generate_hunyuan3d_model`	AI	Generates a 3D model from text or image using Hunyuan3D.
`poll_hunyuan_job_status`	AI	Checks the generation status of a Hunyuan3D job.
`import_generated_asset_hunyuan`	AI	Imports a completed Hunyuan3D model into Blender.

Asset Priority Guide

When you need an asset, the right integration depends on what you are building:

Sketchfab for specific, realistic objects with detailed geometry and textures.
Poly Pizza for stylised, low-poly game assets. The library includes over 10,600 free models.
Poly Haven for generic objects, furniture, HDRIs, and PBR textures.
Hyper3D Rodin or Hunyuan3D for custom, unique items that do not exist in any library. These are AI generation services that create models from text or images.

Start with library assets when possible. They are faster to download and usually higher quality than generated models for common objects.

Limitations

Complex operations may need to be broken into smaller steps. The AI client works best with incremental, explicit instructions rather than single large prompts that try to do everything at once. Blender must be running with a GUI. Headless mode (blender -b) is not supported unless you use xvfb-run -a blender to provide a virtual display. Only one MCP server instance can connect to Blender at a time. Do not run both Cursor and Claude Desktop against the same Blender session simultaneously.

Get Started

Core Concepts

Integrations

Use Cases

Reference

Blender MCP Capabilities: What You Can Build

Capability Overview

Scene Inspection

Object Manipulation

Material Control

Code Execution

Asset Integration

Viewport Screenshots

Full Tool Reference

Asset Priority Guide

Limitations

​Capability Overview

Scene Inspection

Object Manipulation

Material Control

Code Execution

Asset Integration

Viewport Screenshots

​Full Tool Reference

​Asset Priority Guide

​Limitations

Capability Overview

Full Tool Reference

Asset Priority Guide

Limitations