MCP for Blender

// 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.

# 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"

claude mcp add blender uvx mcp-for-blender

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

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

uvx mcp-for-blender install-addon

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.