Guide · Open source

How to use mcp-for-blender: install, connect and prompt Blender

Updated 2026-10-29 · written with AI from the project's own documentation and checked against our catalogue data

mcp-for-blender is a community plugin that lets an AI chat app, such as Claude, create and change objects in Blender 3D using plain-language instructions. It is a third-party project and is not made by the Blender Foundation. After this guide you will be able to install the prerequisites, run the one-command setup, enable the Blender add-on, connect your AI app and send your first request.

MCP for Blenderahujasid/mcp-for-blender · ★ 33k · MIT Install options & downloads

Quick start

1Check prerequisites. Confirm Blender 3.0 or newer and Python 3.10 or newer are installed, and install the uv package manager.
2Run the setup. Run the one-command installer for macOS or Linux, or the PowerShell command on Windows. If uv is already installed, run uvx mcp-for-blender setup.
3Enable the add-on. In Blender, open Edit, Preferences, Add-ons and enable Interface: MCP for Blender. Use uvx mcp-for-blender install-addon if you install manually.
4Add the server to your AI app. Add a blender entry that runs uvx mcp-for-blender in your MCP client, such as Claude Desktop, Cursor or VS Code.
5Restart the AI app. Fully quit and reopen the AI app so it loads the new server.
6Start the Blender server. Press N in the 3D viewport, open the MCP for Blender tab and click Start MCP Server if needed.
7Send a first request. Ask the AI to build a simple object, then check the result in Blender.

What you need before installing

The README lists three prerequisites: Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. uv is what runs the MCP server through the uvx command.

Blender 3.0 or newer
Python 3.10 or newer
uv package manager (install with the official installer, not pip install uv)

Install with the one-command setup

The quickest route is the installer script. It installs uv if needed, finds the MCP clients on your machine, lets you pick which to configure, then installs and enables the Blender add-on. Existing config is kept: it only adds a blender entry and saves a .bak copy of each file it changes.

On macOS or Linux, run the command below. On Windows, use the PowerShell command in the README instead. If you already have uv, run the setup command directly.

curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

Install the Blender add-on manually

If you skip automatic setup or it fails, install the add-on yourself. In Blender, go to Edit, then Preferences, then Add-ons, and enable Interface: MCP for Blender. The add-on runs a socket server inside Blender that receives and executes commands.

Open Blender, then Edit > Preferences > Add-ons
Enable Interface: MCP for Blender

uvx mcp-for-blender install-addon

Connect your AI app to the server

Add the server to your MCP client. The README covers Claude Desktop, Claude Code, Codex, Cursor, VS Code, OpenCode and Antigravity. For Claude Desktop, open Settings, then Developer, then Edit Config, and add a blender entry that runs uvx mcp-for-blender.

Fully quit and reopen the AI app afterwards. On Windows, quit it from the system tray. Only run one instance of the MCP server, either in Cursor or Claude Desktop, not both.

Claude Code: claude mcp add blender uvx mcp-for-blender
Codex: codex mcp add blender -- uvx mcp-for-blender

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

Start the connection and check it

The add-on starts its server when Blender opens. To check, press N in the 3D viewport and open the MCP for Blender tab. If the server is not running, click Start MCP Server.

Then ask your AI app to build something simple, such as a cube, and watch whether it appears in Blender.

Press N in the 3D viewport
Open the MCP for Blender tab
Click Start MCP Server if it is not running

Write prompts that work

The README describes the tool as prompt-assisted modeling and scene manipulation. The project's feature list says the AI can create, modify and delete objects, apply materials and colors, write Blender Python directly, and check its own work with multi-angle, camera, wireframe and render views.

Start with small, specific requests and check each result. AI output may not match what you intended, so review scenes before relying on them.

Ask for one object at a time, then refine it
Ask for a material or color change as a separate step
Check the result in Blender before building on it

What people use it for

Describing a simple object, such as a cube or a basic prop, in plain language and refining it
Applying materials and colors to existing objects through a chat prompt
Generating scene layouts or checking camera and render views with the AI
Trying AI-assisted 3D workflows as a developer exploring the Model Context Protocol

Frequently asked questions

Is mcp-for-blender free?

The project is released under the MIT licence, as shown in the README. The README also mentions an optional Premium offer for generating AI 3D models without your own API keys; check the project's site for its terms.

What are the requirements for mcp-for-blender?

The README lists Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. You also need an MCP-capable AI app such as Claude, Cursor or VS Code.

Is mcp-for-blender official?

No. The README states it is a third-party integration and not made by the Blender Foundation. It is a community plugin.

How do I install mcp-for-blender?

Run the one-command setup for macOS or Linux, or the PowerShell command on Windows. Alternatively, install uv, run uvx mcp-for-blender setup, then install the add-on with uvx mcp-for-blender install-addon.

Why won't my AI app connect to Blender?

Check that the add-on is enabled in Blender and that the server is running in the MCP for Blender tab in the 3D viewport. Then fully quit and reopen your AI app, and make sure only one MCP server instance is running.

What are alternatives to mcp-for-blender?

The README lists blender-mcp and forks of ahujasid/blender-mcp as comparable projects. This package was formerly named blender-mcp, and existing setups keep working without config changes.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

mcp-for-blender suits Blender users who want to experiment with describing scenes in plain language, and developers curious about the Model Context Protocol. It is a poor fit if you need fully predictable hand-controlled modeling, dislike installing Python tooling and add-ons, or need an officially supported Blender integration, since the README says it is third-party.

Install options & downloads