uvx mcp-for-blender setupRun it in a terminal, then start a new agent session so the skill loads. Read the repo's README and scripts before you install: skills run with your agent's permissions.
What it does
MCP for Blender, formerly called blender-mcp, connects AI agents to a running copy of Blender. It has two parts: a Blender add-on that opens a local socket server inside Blender, and a Python MCP server that your agent talks to. The project says it is a third-party integration and not made by Blender.
The agent writes Blender Python itself for modeling, layout, materials, animation, rigging and retopology, and the MCP adds nine tools on top. They run code in your live Blender, show the agent the result from the viewport, a camera, multiple angles, wireframe or X-ray views, renders or animation strips, summarize the scene, and search and import Poly Haven HDRIs, textures and models, Sketchfab models and Poly Pizza low-poly models. A generate_3d tool can create and import a model with Tripo, Hunyuan3D, Hyper3D Rodin or Meshy.
A setup command finds the MCP clients on your machine (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Devin Desktop/Windsurf, OpenCode and Antigravity), adds a blender entry to each, and installs and enables the add-on. It needs Blender 3.0 or newer, Python 3.10 or newer and the uv package manager. A paid Premium option generates AI 3D models without bringing your own API keys.
Install and setup
The quickest route is the one-line installer from the README. On macOS or Linux it's a curl command that pipes install.sh from mcp-for-blender.com into sh, and on Windows it's a PowerShell command that runs install.ps1. If you already have uv, run uvx mcp-for-blender setup instead. On Windows you can also install uv with winget install --id=astral-sh.uv -e, open a new terminal and run the same setup command, which avoids running a script if Windows Defender blocks it.
Setup installs uv if it's missing, finds the MCP clients on your machine (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Devin Desktop/Windsurf, OpenCode and Antigravity) and lets you pick which ones to configure. It keeps your existing config, only adds a blender entry and saves a .bak copy of every file it changes. Then it installs the Blender add-on and enables it. Afterwards, fully quit and reopen your AI app (on Windows, quit it from the system tray), open Blender and ask for something. The add-on starts its server when Blender opens.
If you'd rather do it by hand, there are three steps. Install uv with its official installer, not pip install uv, which may not create the uvx command. Add the server to your client: for Claude Code that's claude mcp add blender uvx mcp-for-blender, for Codex it's codex mcp add blender -- uvx mcp-for-blender, and Claude Desktop, Cursor, VS Code, OpenCode and Antigravity take a short JSON entry that runs uvx mcp-for-blender. Then run uvx mcp-for-blender install-addon, and in Blender go to Edit > Preferences > Add-ons and enable Interface: MCP for Blender. To check the connection, press N in the 3D viewport, open the MCP for Blender tab and click Start MCP Server if it isn't running.
You need Blender 3.0 or newer, Python 3.10 or newer and uv. If you'd rather not use uv, the README also covers installing with pipx or running the MCP server in Docker, while Blender itself stays on your machine. Existing users of the old blender-mcp package don't have to change anything, since uvx blender-mcp still runs the server, but new installs should use the mcp-for-blender name. To update both the server and the add-on, run uvx mcp-for-blender@latest update, then restart your MCP client and Blender.
A typical workflow
Open Blender first, then start a chat in your agent. The agent writes Blender Python itself for modeling, layout, materials, animation, rigging and retopology, and sends it to your live Blender through the execute_blender_code tool. It then uses the look tool to see the result from the viewport, the scene camera, an auto-framed multi-angle sheet or an animation strip, drawn solid, with materials, rendered, as wireframe or in X-ray. That lets it check its own work and fix things like a chair floating above the floor without you describing the problem.
The README's example prompts give a good feel for the scale of requests that work: create a sphere and place it above the cube, make this car red and metallic, make the lighting like a studio, point the camera at the scene and make it isometric, or create a low poly dungeon scene with a dragon guarding a pot of gold. You can also hand it a reference image and ask it to build a Blender scene from it. get_scene_info gives the agent a compact one-line-per-object summary of the scene, so it can work with what's already there.
For assets, tick the sources you want in the MCP for Blender sidebar tab. Poly Haven needs no account or key and covers HDRIs, textures and models, all CC0. Poly Pizza has free low-poly models and needs a free API key. Sketchfab is also supported. The agent searches with search_assets and imports with import_asset, for example a CC0 low-poly chair scaled to 1 metre tall, or a rusty metal texture applied straight to a wall. When you need something that doesn't exist, generate_3d creates and imports a model with Tripo, Hunyuan3D, Hyper3D Rodin or Meshy, on your own API key or through the paid Premium option.
For a game, the usual loop is to block out or generate the asset, let the agent check it from several angles, refine the materials and then export it to your engine yourself or ask the agent to do the export in Python. Keep each request small. The README's own advice for timeouts is to simplify requests or break them into smaller steps.
Gotchas
Save your work before every session. The execute_blender_code tool runs arbitrary Python in your Blender, and the README warns it can be dangerous. Setting BLENDER_MCP_SAFE_MODE=1 makes the server check each script first and block risky code such as reading or writing files directly, running other programs or accessing the network, while normal modeling, materials, rendering, saving and import and export still work. Blocked scripts go back to the agent with the reason so it can try again.
The add-on's socket server, on port 9876 by default, has no authentication or encryption, so anyone who can reach that port can run Python inside Blender. Keep it on localhost unless you're on a trusted network. Run only one copy of the MCP server at a time, for example in Cursor or in Claude Desktop, not both. You can run several Blender instances side by side by giving each its own port with --port and matching it in the add-on panel.
Clients launched from the Dock or Start menu often can't see your terminal's PATH, so a plain uvx command can fail with spawn uvx ENOENT. The fix is to use the full path to uvx, or on Windows to run it through cmd /c, and then fully quit and relaunch the client. If conda, pyenv or a very new Python gets in the way, the README shows how to pin Python 3.11 for uvx. Don't run the uvx command yourself in a terminal; your MCP client starts it. The first command sometimes doesn't go through, and restarting both the client and the Blender server usually fixes connection errors.
Poly Haven downloads run on Blender's main thread, so Blender stops responding until a download finishes. Ask for 1k or 2k textures unless the asset is close to the camera. Poly Pizza downloads can be blocked from VPN, datacenter and cloud IP addresses. About 69 percent of Poly Pizza's catalogue is CC-BY and needs a credit to the creator; the add-on writes the credit line onto the imported object, or you can filter for CC0 models.
By default the server sends a minimal anonymous usage record: a random install ID, a session ID, the tool name, whether it worked, how long it took, the add-on and Blender versions, your operating system and a timestamp. Your prompts, code, screenshots and scene data are only collected if you opt in. Set DISABLE_TELEMETRY=true in the server's environment to turn it off completely.
Who it's for
MCP for Blender suits game makers who already use an AI agent such as Claude Code, Codex or Cursor and want it to build or edit props, environments and scenes in Blender rather than just describe menu clicks. It's a good fit for blocking out levels, dressing scenes with free Poly Haven and Poly Pizza assets, setting up lighting and cameras, and turning AI-generated models from Tripo, Meshy, Hyper3D Rodin or Hunyuan3D into something you can tweak and export.
It's less useful if you don't use Blender at all, or if you want finished, production-quality characters with no cleanup. The agent works through Blender Python, so complex jobs still need to be broken into steps and checked. It's free and open source under the MIT license; you only pay for your AI agent, and optionally for Premium or your own API keys for AI model generation. The project says it's a third-party integration and isn't made by Blender.
Features
- Runs Blender Python in your live Blender
- Viewport, camera, multi-angle and render views so the agent checks its work
- Imports Poly Haven, Sketchfab and Poly Pizza assets
- Generates and imports models with Tripo, Hunyuan3D, Hyper3D Rodin or Meshy
- One setup command configures your agents and the add-on
Limits
- Running arbitrary Python can damage a scene, so save your work first
- Sends a minimal anonymous usage record unless you set DISABLE_TELEMETRY
- Built-in AI model generation needs your own API keys or the paid Premium plan
Questions people ask
How do I install MCP for Blender?
Run the one-line installer from the README, or uvx mcp-for-blender setup if you already have uv. It configures the MCP clients you pick, such as Claude Code, Claude Desktop, Codex or Cursor, and installs and enables the Blender add-on. Then fully quit and reopen your AI app and open Blender. You can also set it up by hand: add uvx mcp-for-blender to your client, run uvx mcp-for-blender install-addon and enable Interface: MCP for Blender in Blender's add-on preferences.
Which Blender versions does MCP for Blender support?
The README lists Blender 3.0 or newer, plus Python 3.10 or newer and the uv package manager.
Does MCP for Blender work with Cursor, Codex or only Claude?
It works with several MCP clients. The setup command finds and configures Claude Desktop, Claude Code, Codex, Cursor, VS Code, Devin Desktop/Windsurf, OpenCode and Antigravity. Codex also has an optional plugin that adds a live viewport in the chat and thumbnail pickers for Poly Haven, Sketchfab and Poly Pizza.
Is MCP for Blender free?
Yes. It's free and open source under the MIT license. Poly Haven assets are free with no key, and Poly Pizza needs a free API key. Generating AI 3D models with Tripo, Meshy, Hyper3D Rodin or Hunyuan3D needs your own API keys for those services or the paid Premium option.
Is blender-mcp the same as MCP for Blender?
Yes. blender-mcp is the old name of the same project, and the PyPI package is now mcp-for-blender. Existing setups keep working with no config change, since uvx blender-mcp still runs the server, but new installs should use mcp-for-blender.
Is it safe to let an AI agent run Python in Blender?
Treat it with care. The README warns that running arbitrary Python can be dangerous and says to always save your work first. Turning on safe mode with BLENDER_MCP_SAFE_MODE=1 blocks risky scripts such as file access, running other programs and network calls, while normal Blender work still runs. The add-on's socket server has no authentication, so keep it on localhost.
Why can't my AI app connect to Blender?
Check that the add-on's server is running in the MCP for Blender sidebar tab (press N in the 3D viewport) and that only one client is running the MCP server. If you see spawn uvx ENOENT, your app can't find uvx, so use its full path and fully restart the app. The first command sometimes fails, and restarting both your AI app and the Blender server often fixes it.
Similar skills and which to pick
- Blender SkillsNot a replacement but an add-on: these 94 skills run through MCP for Blender, so add them if you want guided pipelines for game-ready props, LODs and engine exports.
- Blender Agent SkillsPick these 22 skills if you're on Blender 5.2 or newer and want them to work even without an MCP server, by running Blender in the background; they can also use one like MCP for Blender.
- Blockbench MCPPick Blockbench MCP for Minecraft-style blocky models in Blockbench; pick MCP for Blender for general 3D work.
- Best AI 3D model generatorCompare Meshy, Tripo, Hyper3D Rodin and other generators you can call from MCP for Blender's generate_3d tool.