Blender MCP Server

Connects Claude and other MCP clients to Blender for prompt-driven 3D modeling, scene creation, material control, asset import, and AI 3D generation.

Design by Siddharth Ahuja (community) None active

GitHub Docs

Overview

BlenderMCP is a community-built Model Context Protocol server that bridges AI assistants like Claude with Blender, the open-source 3D creation suite. It enables prompt-assisted 3D modeling, scene creation, and manipulation through a two-way socket connection between an MCP server (run via uvx) and a Blender addon installed inside the application. The user works in natural language while the agent inspects the scene, creates and modifies objects, applies materials, captures viewport screenshots, and executes arbitrary Python in Blender's runtime.

Beyond direct scene control, the server integrates several asset and AI generation backends. It can search and download HDRIs, textures, and models from Poly Haven, browse and import models from Sketchfab, and generate new 3D assets from text or images using Hyper3D Rodin and Hunyuan3D. This lets an agent assemble fully populated scenes (geometry, materials, environment lighting, and generated meshes) without leaving the chat.

The project is not maintained by the Blender Foundation. It is an independent open-source project (MIT licensed) by Siddharth Ahuja, but it has become the de facto canonical Blender MCP integration, with significant community adoption. The execute_blender_code tool exposes the full Blender Python API, which is powerful but also a security consideration since arbitrary code can run inside Blender.

Tools

Tool	Description
`get_scene_info`	Get detailed information about the current Blender scene.
`get_object_info`	Get detailed information about a specific object in the scene.
`get_viewport_screenshot`	Capture a screenshot of the current Blender 3D viewport.
`execute_blender_code`	Execute arbitrary Python code inside Blender.
`get_polyhaven_categories`	List asset categories on Poly Haven for a given asset type.
`search_polyhaven_assets`	Search Poly Haven for HDRIs, textures, or models with optional filters.
`download_polyhaven_asset`	Download and import a Poly Haven asset into Blender.
`set_texture`	Apply a previously downloaded Poly Haven texture to an object.
`get_polyhaven_status`	Check whether Poly Haven integration is enabled in the Blender addon.
`get_hyper3d_status`	Check whether Hyper3D Rodin integration is enabled.
`get_sketchfab_status`	Check whether Sketchfab integration is enabled.
`search_sketchfab_models`	Search Sketchfab models with optional filtering.
`get_sketchfab_model_preview`	Get a preview thumbnail of a Sketchfab model by UID.
`download_sketchfab_model`	Download and import a Sketchfab model by UID.
`generate_hyper3d_model_via_text`	Generate a 3D asset with Hyper3D Rodin from a text prompt.
`generate_hyper3d_model_via_images`	Generate a 3D asset with Hyper3D Rodin from input images.
`poll_rodin_job_status`	Check status of a Hyper3D Rodin generation job.
`import_generated_asset`	Import the asset produced by a completed Rodin job.
`get_hunyuan3d_status`	Check whether Hunyuan3D integration is enabled.
`generate_hunyuan3d_model`	Generate a 3D asset with Hunyuan3D from text or image input.
`poll_hunyuan_job_status`	Check status of a Hunyuan3D generation job.
`import_generated_asset_hunyuan`	Import an asset produced by a completed Hunyuan3D job.

Setup Guide

Prerequisites

Blender 3.0 or newer
Python 3.10+
uv package manager installed (pip install uv or follow https://docs.astral.sh/uv/)

Install the Blender addon

Download addon.py from the repository.
In Blender: Edit > Preferences > Add-ons > Install, select addon.py.
Enable "Interface: Blender MCP".
Open the 3D View sidebar (press N) and find the BlenderMCP tab.
Click "Connect to Claude" to start the socket listener inside Blender.

Configure Claude Desktop

Add the following to claude_desktop_config.json (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"]
    }
  }
}

Restart Claude Desktop. The server is launched via uvx blender-mcp and talks to the running Blender addon over a local socket.

Optional integrations

Poly Haven: enable the Poly Haven checkbox in the BlenderMCP sidebar.
Sketchfab: requires a Sketchfab API token entered in the addon panel.
Hyper3D Rodin: free trial keys with daily limits, or supply your own.
Hunyuan3D: configure via the addon panel.

Set DISABLE_TELEMETRY=true in the environment to opt out of anonymous telemetry.

Use Cases

Build a quick 3D scene from a natural-language brief (e.g. "a low-poly desk with a lamp and laptop on it") with the agent creating objects, applying materials, and lighting the scene.
Drop in production-ready assets from Poly Haven (HDRI environments, PBR textures, free models) and Sketchfab without leaving the chat.
Generate custom meshes from text prompts or reference images using Hyper3D Rodin or Hunyuan3D, then import them straight into the active scene.
Inspect and debug existing .blend files by asking the agent to summarize the scene graph, dump object properties, or screenshot the viewport.
Automate repetitive Blender tasks (batch renames, modifier setup, procedural geometry) by having the agent write and run Python through execute_blender_code.

Example Prompts

"Create a simple living room scene: a couch, a coffee table, a rug, and a window with an HDRI from Poly Haven for lighting."
"Search Sketchfab for a downloadable low-poly tree and import three copies into the scene."
"Generate a 3D model of a vintage rotary telephone with Hyper3D Rodin and place it on the desk."
"Take a viewport screenshot and tell me what materials are missing."
"Write Blender Python to add a Subdivision Surface modifier with viewport level 2 to every selected mesh."

Pros

Most widely adopted Blender MCP integration (21k+ GitHub stars, MIT licensed).
Broad capability surface: scene inspection, object manipulation, materials, viewport screenshots, and arbitrary Python execution.
Bundled integrations with Poly Haven, Sketchfab, Hyper3D Rodin, and Hunyuan3D for assets and AI 3D generation.
Simple setup via uvx blender-mcp plus a single Blender addon file.

Limitations

Community project, not maintained by the Blender Foundation.
execute_blender_code runs arbitrary Python inside Blender, which is powerful but a real security risk if prompts come from untrusted sources.
Complex multi-step modeling often needs to be broken down manually; results from generative backends vary in quality.

Alternatives

CommonSenseMachines/blender-mcp: text and image based scene editing in Blender via CSM.ai.
dhakalnirajan/blender-open-mcp: Blender MCP wired to a local Ollama LLM.
djeada/blender-mcp-server: alternative implementation with 22 tools across 6 namespaces.