explaingit

ahujasid/blender-mcp

21,335PythonAudience · developerComplexity · 3/5MaintainedLicenseSetup · hard

TLDR

Connect Claude AI to Blender via natural language. Tell Claude what to build in 3D and it controls Blender directly, creating objects, applying materials, adjusting lighting, and running code.

Mindmap

mindmap
  root((BlenderMCP))
    What it does
      Control Blender with AI
      Create 3D objects
      Apply materials
      Adjust lighting
    How it works
      Blender addon
      MCP server bridge
      Socket connection
      Claude integration
    Features
      Asset downloads
      AI model generation
      Screenshot viewing
      Model searching
    Use cases
      Scene creation
      Lighting design
      Asset management
      Rapid prototyping
    Setup
      Install addon
      Configure MCP
      Connect Claude
      Remote hosting

Things people build with this

USE CASE 1

Create complex 3D scenes by describing them in plain English, like 'build a low poly dungeon with a dragon guarding treasure.'

USE CASE 2

Rapidly prototype 3D designs by asking Claude to adjust lighting, materials, and object placement without manual clicking.

USE CASE 3

Download and apply free 3D assets, HDRIs, and models from Poly Haven and Sketchfab directly into your scene.

USE CASE 4

Generate AI-powered 3D models using Hyper3D Rodin and integrate them into your Blender project automatically.

Tech stack

PythonBlenderModel Context ProtocolClaude API

Getting it running

Difficulty · hard Time to first run · 1h+

Requires Blender installation, Claude API key, and Model Context Protocol setup with multiple dependencies.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

BlenderMCP is a bridge that lets Claude, an AI assistant, drive Blender, the popular open-source 3D modeling and animation software. You tell Claude in plain English what you want, "create a low poly dungeon with a dragon guarding a pot of gold", "make this car red and metallic", "set up studio lighting", and Claude actually carries the request out inside Blender, creating objects, applying materials, adjusting the camera, and so on. The goal is prompt-driven 3D modeling, where the heavy lifting of clicking through menus and writing Python scripts is offloaded to the AI. The project works by combining two pieces. The first is a Blender addon called addon.py that you install through Blender's preferences; it runs a small socket server inside Blender that listens for incoming commands. The second is an MCP server, written in Python, that implements the Model Context Protocol, a standard way for AI tools to talk to external programs. The MCP server forwards Claude's requests to the addon, the addon executes them in Blender, and results travel back. You connect to it from Claude Desktop, Claude Code, Cursor, or Visual Studio Code by adding a small entry to that tool's MCP configuration. The capabilities exposed to Claude include reading the current scene and getting information about objects, creating and deleting and modifying shapes, applying or creating materials, taking viewport screenshots so the AI can see what is happening, and running arbitrary Python code inside Blender. The integration also reaches out to outside services: it can search and download Sketchfab models, pull assets and HDRI environment maps from Poly Haven, and generate new 3D models on demand through Hyper3D Rodin and a related option called Hunyuan3D. You would install BlenderMCP if you already use Blender and want to drive it conversationally through Claude, for example, to rough out a scene from a written description or a reference image, to fetch and place assets without leaving the conversation, or to ask the AI to inspect a scene and write code from it. Setup requires Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager, plus configuring whichever AI client you use to launch the MCP server with uvx. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Set up BlenderMCP to control Blender from Claude. I want to create a 3D scene by typing natural language prompts instead of clicking in Blender.
Prompt 2
Use BlenderMCP to create a sci-fi spaceship interior with metallic materials and dramatic lighting. Show me the steps to prompt Claude for this.
Prompt 3
How do I configure the Blender addon and MCP server so Claude can download free 3D assets from Poly Haven and place them in my scene?
Prompt 4
I want to use BlenderMCP to generate an AI 3D model via Hyper3D Rodin and automatically add it to my Blender project. Walk me through the setup.
Prompt 5
Show me how to run Blender on a remote machine and control it from Claude using BlenderMCP's remote hosting feature.
Open on GitHub → Explain another repo

Generated 2026-05-21 · Model: sonnet-4-6 · Verify against the repo before relying on details.