█

AI/TLDR

Buy me a coffee
Buy me a coffee

MCP for Blender

Let an LLM build and edit 3D scenes inside Blender from a chat prompt

3D & CAD GenerationOpen source
Latest
2.0.0
Updated
16 Sep 2026
Language
Python
License
MIT

What's new

2.0.016 Sep 2026

The project ships as `mcp-for-blender` — that is the PyPI package name `uvx` and `pipx` install, and the repository and Blender addon panel carry the same name. Version 2.0.0 was published to PyPI on this date.

IN SHORT

What is MCP for Blender?

MCP for Blender connects Blender to any LLM that speaks the Model Context Protocol, so you can describe a 3D scene in plain language and watch the model build it. It sits in the 3D & CAD Generation category of the Multimodal Generation tools and is open-source, written in Python and licensed MIT.

Updated Markdown version ↗

Overview

MCP for Blender connects Blender to any LLM that speaks the Model Context Protocol, so you can describe a 3D scene in plain language and watch the model build it. Ask for a low-poly dungeon with a dragon guarding a pot of gold, or tell it to make a car red and metallic, and the assistant issues real Blender commands rather than handing you a script to paste.

The project has two halves. A Blender addon (`addon.py`) starts a socket server inside Blender itself, and a Python MCP server (`src/blender_mcp/server.py`) exposes that connection to your MCP client. The two talk over TCP with a simple JSON protocol: commands carry a `type` and optional `params`, responses carry a `status` plus a result or message. Because the addon runs in-process, the model can inspect the live scene as well as change it.

Beyond primitive shapes and materials, the server wires in asset sources: Poly Haven for models, textures and HDRIs, Sketchfab and Poly Pizza for downloadable models, and Hyper3D Rodin and Hunyuan3D for AI-generated 3D assets. API keys for those services can be stored in the addon's preferences so they survive a Blender restart, or injected through `BLENDERMCP_*` environment variables for headless and CI setups. It is MIT-licensed and published to PyPI as `mcp-for-blender`, run with `uvx`.

One capability deserves care: the `execute_blender_code` tool runs arbitrary Python inside Blender. The project's own README flags this as powerful but dangerous and tells you to save your work first. The same README also notes that only one instance of the MCP server should run at a time — pointing both Claude Desktop and Cursor at it simultaneously causes connection problems.

What it does

  • Two-way socket connection between an MCP client and a running Blender instance
  • Create, modify and delete 3D objects, and apply or author materials and colours from a prompt
  • Scene inspection — the model can read the current scene's objects and properties before changing them
  • Asset pipelines built in: Poly Haven models, textures and HDRIs, plus Sketchfab and Poly Pizza model search and download
  • AI-generated 3D models through Hyper3D Rodin and Hunyuan3D, with keys stored in addon preferences or environment variables
  • `execute_blender_code` for running arbitrary Python in Blender when the built-in tools are not enough

Getting started

Three steps: install uv, point your MCP client at the server, and install the Blender addon. You need Blender 3.0 or newer and Python 3.10 or newer. Install uv with its official installer — the README warns that `pip install uv` may not create the `uvx` command your MCP client needs.

Install uv

Use the official installer for your platform.

bashbash
# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Add the MCP server to your client

The PyPI package is named mcp-for-blender. Claude Code and Codex each register it with one command.

bashbash
claude mcp add blender uvx mcp-for-blender

# or, for Codex
codex mcp add blender -- uvx mcp-for-blender

Or configure Claude Desktop by hand

Add the server to the mcpServers block under Settings → Developer → Edit Config.

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

Install the Blender addon

Run the installer, then enable it in Blender under Edit → Preferences → Add-ons → Interface: MCP for Blender.

bashbash
uvx mcp-for-blender install-addon

Connect and prompt

In Blender's 3D viewport press N, open the MCP for Blender tab, and click Start MCP Server. Your assistant will show a hammer icon with the Blender tools. Run only one MCP server instance at a time — not Cursor and Claude Desktop together.

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

When to use it

  • Block out a 3D scene from a written description instead of clicking through Blender's modelling tools
  • Populate a scene with real assets — Poly Haven HDRIs and textures, Sketchfab models — without leaving the conversation
  • Recreate a reference image as a Blender scene, or read an existing scene back out into another format
  • Batch-edit materials, lighting and camera framing across a scene using natural-language instructions

How MCP for Blender compares

MCP for Blender alongside other open-source 3d & cad generation tools AI/TLDR tracks, ranked by GitHub stars.

ToolStarsWhat it does
MCP for Blender★ 34.6kLet an LLM build and edit 3D scenes inside Blender from a chat prompt
text-to-cad★ 26.4kA library of agent skills for CAD, CAE and CAM: plain-language to STEP models, DXF drawings, URDF/SRDF/SDF robot files, printability checks and sliced G-code.
Pascal Editor★ 25.5kA local-first 3D building editor built on React Three Fiber and WebGPU, with a typed architectural node hierarchy and an authenticated MCP service so AI agents can inspect and edit the scene.
img2threejs★ 21.4kAn agent skill that rebuilds the object in a single reference image as procedural, animation-ready Three.js code, gating each sculpting pass on a vision review against the reference.
SolidCraft★ 16.6kAn open-source parametric 3D CAD app in Rust for desktop and browser, with a built-in MCP server so AI agents can sketch, model, measure and export editable parts.
CADAM★ 5.4kAn open-source text-to-CAD web app that has an LLM write OpenSCAD, then exposes the model's parameters as live sliders and exports STL, SCAD and DXF.
AssetFurnace★ 1.2kA local studio and CLI that turns a prompt or picture into a textured, rigged and animated GLB game asset through Pixal3D, TRELLIS.2 or Hunyuan3D, on Apple Silicon, NVIDIA or AMD.
MAC (Multi-Agent CAD)★ 1.1kA multi-agent framework that turns natural-language design briefs into editable CAD parts and multi-part assemblies, exporting STEP, STL, GLB and URDF.