# MCP for Blender

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

- Category: Multimodal Generation / 3D & CAD Generation
- Language: Python
- Licence: MIT
- Repository: https://github.com/ahujasid/mcp-for-blender
- Website: https://mcp-for-blender.com/
- Canonical page: https://ai-tldr.dev/tools/blender-mcp/
- Updated: 2026-09-16

## In short

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.

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

1. Install uv

   Use the official installer for your platform.

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

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

```bash
claude mcp add blender uvx mcp-for-blender

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

3. Or configure Claude Desktop by hand

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

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

4. Install the Blender addon

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

```bash
uvx mcp-for-blender install-addon
```

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

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

## Version history

- 2026-09-16 2.0.0: 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.
