gitwtfhub

wtf is blender-mcp?

ahujasid/blender-mcp — explained in plain English

Analysis updated 2026-05-18

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

TL;DR

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

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

PythonBlenderModel Context ProtocolClaude API

How it stacks up

ahujasid/blender-mcpgoauthentik/authentikmementum/backtrader
Stars21,33521,34721,413
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity3/54/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

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.

Wtf does this do

BlenderMCP is a bridge between Blender, the open-source 3D modelling program, and Claude AI through the Model Context Protocol. Once installed, you can ask Claude in plain language to build and edit 3D scenes inside Blender, creating objects, changing materials and colours, inspecting what is already in the scene, and even running custom Python code in Blender, instead of clicking through Blender's menus yourself. The system has two parts that talk to each other over a socket. A Blender add-on (addon.py) runs inside Blender and exposes a small server that receives commands. A separate MCP server (the Python package blender-mcp) implements the Model Context Protocol so that Claude can call those commands as tools. You install the add-on through Blender's preferences, then point Claude for Desktop, Claude Code, Cursor, or Visual Studio Code at the MCP server by editing a configuration file. The connection itself is started from a "BlenderMCP" panel in Blender's 3D view sidebar. The host and port the add-on listens on can be set with the BLENDER_HOST and BLENDER_PORT environment variables. Beyond direct scene editing, the integration can pull free assets from Poly Haven through its API, search and download models from Sketchfab, generate new 3D models with Hyper3D Rodin or Hunyuan3D, and capture viewport screenshots so Claude can see what the scene currently looks like. Example prompts in the README include making a low-poly dungeon with a dragon, recreating a beach scene from HDRIs and Poly Haven assets, or turning a reference image into a Blender scene. The project needs Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. It is written in Python.

Yoink these 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.

Frequently asked questions

wtf is blender-mcp?

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.

What language is blender-mcp written in?

Mainly Python. The stack also includes Python, Blender, Model Context Protocol.

What license does blender-mcp use?

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

How hard is blender-mcp to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is blender-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.