MCP/Blender MCP

Blender MCP

Connects Blender to Claude AI and coding assistants, letting you create and modify 3D scenes, objects, materials, and textures using natural language prompts.

design•3D Modeling & Computer Graphics

GitHub102

License:MIT

COMMUNITY

@Siddharth Ahuja

About this Server

Connects Blender to Claude AI and coding assistants, letting you create and modify 3D scenes, objects, and materials using natural language prompts. AI can execute Python code directly in Blender, inspect scene properties, capture viewport screenshots, download and apply PBR textures from Poly Haven, search and import Sketchfab models, and generate 3D assets using Hyper3D Rodin and Hunyuan3D generative AI integrations.

Real-time Interaction

Direct low-latency RPC protocol communication with structured JSON schemas.

Scoped Sandboxing

Restricted capability bounds to prevent accidental modifications or leakage.

Security & Best Practices

Local Socket Sandboxing: Blender MCP connects to a local Blender Python session over localhost loopback sockets without exposing ports publicly.

Step-by-step Script Execution: Review AI-generated Blender Python scripts before execution to avoid destructive scene overwrites or memory exhaustion.

Asset Origin Validation: Verify Polyhaven and Sketchfab asset licenses and mesh polygon counts before downloading high-poly models into production scenes.

API Credential Isolation: External generative service tokens (Hyper3D, Fal AI, Sketchfab) are configured locally in Blender preferences and never transmitted in plaintext prompts.

When to Use (and When Not To)

Best For

•3D artists and technical directors wanting AI-assisted 3D modeling, lighting, and scene staging
•Developers automating Blender rendering, asset pipelines, and procedural Python scripts
•Learning 3D modeling, shader nodes, and bpy scripting with interactive AI guidance
•Rapid prototyping of 3D architectural mockups, game assets, and PBR textured props

Not For / Limitations

•Headless server environments where Blender is not installed or GUI viewport rendering is unsupported
•Pure 2D vector or web-only layout designs that do not involve 3D meshes or bpy automation
•Real-time production game engines without an intermediate export step (FBX, glTF, or OBJ)

Install & Setup

One-line terminal command

terminal command

$claude mcp add blender -- uvx blender-mcp

Exposed Tools & Endpoints

21 tools

Functions your AI agent can invoke via this Model Context Protocol server

get_scene_info• callable tool

Get detailed information about the current Blender scene.

get_object_info• callable tool

Get detailed information about a specific object in the Blender scene. Parameters: object_name.

get_viewport_screenshot• callable tool

Capture a screenshot of the current Blender 3D viewport. Parameters: max_size (default: 800).

execute_blender_code• callable tool

Execute arbitrary Python code in Blender. Parameters: code.

get_polyhaven_categories• callable tool

Get a list of categories for a specific asset type on Polyhaven. Parameters: asset_type (hdris, textures, models, all).

search_polyhaven_assets• callable tool

Search for assets on Polyhaven with optional filtering. Parameters: asset_type, categories.

download_polyhaven_asset• callable tool

Download and import a Polyhaven asset into Blender. Parameters: asset_id, asset_type, resolution, file_format.

set_texture• callable tool

Apply a previously downloaded Polyhaven texture to an object. Parameters: object_name, texture_id.

get_polyhaven_status• callable tool

Check if PolyHaven integration is enabled in Blender.

get_hyper3d_status• callable tool

Check if Hyper3D Rodin integration is enabled in Blender.

get_sketchfab_status• callable tool

Check if Sketchfab integration is enabled in Blender.

search_sketchfab_models• callable tool

Search for models on Sketchfab with optional filtering. Parameters: query, categories, count, downloadable.

download_sketchfab_model• callable tool

Download and import a Sketchfab model by its UID. Parameters: uid.

generate_hyper3d_model_via_text• callable tool

Generate 3D asset using Hyper3D by giving description of the desired asset, and import the asset into Blender. Parameters: text_prompt, bbox_condition.

generate_hyper3d_model_via_images• callable tool

Generate 3D asset using Hyper3D by giving images of the wanted asset, and import the generated asset into Blender. Parameters: input_image_paths, input_image_urls, bbox_condition.

poll_rodin_job_status• callable tool

Check if the Hyper3D Rodin generation task is completed. Parameters: subscription_key or request_id.

import_generated_asset• callable tool

Import the asset generated by Hyper3D Rodin after the generation task is completed. Parameters: name, task_uuid or request_id.

get_hunyuan3d_status• callable tool

Check if Hunyuan3D integration is enabled in Blender.

generate_hunyuan3d_model• callable tool

Generate 3D asset using Hunyuan3D by providing either text description, image reference, or both. Parameters: text_prompt, input_image_url.

poll_hunyuan_job_status• callable tool

Check if the Hunyuan3D generation task is completed. Parameters: job_id.

import_generated_asset_hunyuan• callable tool

Import the asset generated by Hunyuan3D after the generation task is completed. Parameters: name, zip_file_url.