
MCP for Blender, the community Blender MCP server
Not the official Blender MCP server. This one is built by the community. Blender makes its own: Scenario for Blender MCP →
Lets Claude, Codex, Cursor and other AI apps build and change 3D scenes in Blender from plain-language requests.
MCP for Blender lets your AI app create and edit objects, materials and lighting in Blender. It can also pull in free Poly Haven textures and models and start AI 3D model generators. By default the AI can run any Python code inside Blender, so use it only on your own machine and save your work first. If you have Blender 5.1 or newer and do not need asset libraries or AI model generation, pick Blender's official Blender Lab MCP server (the Claude Blender connector) instead.
Good for
- 3D artists who want to describe a scene and have the AI block it out
- Hobbyists building low-poly scenes with free Poly Haven textures and lighting
- Developers who want to turn a Blender scene into web or game code
- People trying AI 3D model generators (Meshy, Tripo, Hunyuan3D, Rodin) inside Blender
Works in
3 supported · 4 with issues · 5 should work
Tap an app to see how to set it up and any known problems.
The README has a one-click install link. GitHub
The README has an Install in VS Code button. GitHub
The setup command finds Windsurf and adds the server. GitHub
Setup is in the README.
Known problems
- Open
The automatic setup command can fail to add the server to Claude Code
Workaround: Run the claude mcp add command by hand.
Since Oct 2026 · GitHub
Setup is in the README. On Windows with Blender 5.1 or 5.2, calls may hang if Blender Lab's add-on is also on.
Known problems
- Open
On Windows with Blender 5.1 or 5.2, every tool call hangs until it times out
Workaround: Disable Blender Lab's MCP add-on, which uses the same port 9876.
Since Aug 2026 · GitHub
- Closed
On Apple Silicon Macs uvx can pick an Intel Python and the install fails
Workaround: Add --python 3.11-aarch64 before the package name in args.
Reported Aug 2026 · GitHub
Setup is in the README, plus a Codex plugin with a live viewport in chat.
Known problems
- Open
The scene-info tool can fail validation when Codex calls it with no arguments
Since Aug 2026 · GitHub
Setup is in the README.
Known problems
- Open
Requests time out and Blender can crash after heavy renders or long sessions
Since Oct 2026 · GitHub
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install MCP for Blender
Claude Code
- 1
Copy this prompt.
Add the MCP for Blender server to Claude Code. Run this command: claude mcp add blender -- uvx mcp-for-blender Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python), Blender with the MCP for Blender addon.
Install the Blender addon once with uvx mcp-for-blender install-addon, then turn on Interface: MCP for Blender under Edit > Preferences > Add-ons. The addon starts its server when Blender opens; if it is not running, press N in the 3D viewport, open the MCP for Blender tab and click Start MCP Server. Run only one MCP server instance, from one client at a time. If a desktop app says spawn uvx ENOENT, use the full path from which uvx as the command. The old package name blender-mcp still works, but new installs use mcp-for-blender. Guided setup finds your clients, edits their config and installs the addon in one pass.
From the project README. Source.
Tools
Shows a short summary of what is in your Blender scene
Returns one line per object with the fields you pick, such as placement, materials and topology. You can drill into a single object.
Try: “Give me a summary of everything in my Blender scene”
Read ·
get_scene_infoTakes a look at your scene from the viewport, a camera or several angles
Returns an image of the viewport, a camera view, a multi-angle sheet or an animation strip, in solid, material, rendered, wireframe or x-ray shading. It can also show a render or image file.
Try: “Show me my scene from the camera in rendered view”
Read ·
lookFinds free models, textures and HDRIs on Poly Haven, Sketchfab and Poly Pizza
Searches the Poly Haven, Sketchfab and Poly Pizza libraries for HDRIs, textures and models.
Try: “Find a wooden floor texture on Poly Haven”
Network ·
search_assetsShows your Blender and add-on versions and which libraries are switched on
Reports the Blender version, the add-on version, and which libraries and generators are switched on.
Try: “Which asset libraries and 3D generators are enabled in my Blender?”
Read ·
get_addon_statusRuns Python code inside your open Blender
Runs Python code in your live Blender session. It can run arbitrary code, so the README warns you to save your work first.
Try: “Add a red cube and place it above the plane”
Runs code ·
execute_blender_codeBrings a found model, texture or HDRI into your scene
Imports an asset from Poly Haven, Sketchfab or Poly Pizza into Blender.
Try: “Import that wooden floor texture into my scene”
Write ·
import_assetGenerates a 3D model from a prompt and adds it to your scene
Generates a model with Tripo, Hunyuan3D, Hyper3D Rodin or Meshy in one call and imports it into Blender. Premium generators are preferred automatically.
Try: “Generate a low-poly treasure chest and import it”
Write ·
generate_3dTurns off anonymous usage data collection
One of the data collection controls.
Try: “Turn off telemetry for the Blender plugin”
Write ·
disable_telemetryRecords feedback about how a session went
One of the data collection controls.
Try: “Send feedback about this Blender session”
Write ·
record_trajectory_feedback
Read from the source code
Pros and cons
Good
- Free and MIT licensed, with setup guides for Claude, Codex, Cursor, VS Code and more.
- Works with Blender 3.0 and newer.
- Pulls in free Poly Haven textures and HDRIs, and Poly Pizza models.
- Can start AI 3D model generators such as Meshy, Tripo, Hunyuan3D and Rodin.
- Safe mode blocks file access, running programs and network calls from AI scripts.
Watch out
- Runs any Python in Blender by default, with no login on the local socket.
- Open reports of file reading and internal URL fetching.
- Sends anonymous usage data unless you turn it off.
- Clashes with Blender's official add-on, which uses the same port.
- Everyday tasks use 69,000 to 126,000 input tokens each.
- Poly Haven downloads freeze Blender until the file arrives.
- Complex requests can time out and need splitting into smaller steps.
Permissions
high risk · 6 things to watch · 4 advisories
High risk
The AI can run any Python code inside Blender, which can read your files, use your network and delete scene content. Use it only on your own machine, turn on safe mode if you can live with its limits, and turn off telemetry.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
AI runs any Python inside Blender
The code tool runs whatever Python the AI writes, with your user's file and network access, unless safe mode is on. Save your work first. github.com
Local socket has no login
Any program that can reach port 9876 can send code to Blender. Keep it on localhost and do not expose the port on a network. github.com
Open reports of file reading and internal URL fetching
October 2026 reports say the Hyper3D image tool can read any local file and the Hunyuan3D image fetch can reach internal network addresses. Both were still open on 2026-11-01. github.com
Usage data is sent unless you turn it off
An anonymous usage record is sent unless DISABLE_TELEMETRY=true. Prompts and screenshots are sent only after opt-in and may be used to train AI models. github.com
Maintainer account takeover reported in Aug 2026
A Hacker News post on 2026-08-10 linked the maintainer's report that his GitHub account was hacked. A commit pushed under another name on 2026-08-09 is not on the current main branch. Update to the latest release. news.ycombinator.com
Port clash with Blender's own MCP add-on
Blender Lab's MCP add-on also uses port 9876. With both enabled, tool calls can hang, so disable one of them. github.com
Security advisories
4 known advisories, 3 with no fixed version yet.
- A tampered Poly Haven download could write files anywhere on your computer, such as startup scriptsmedium · Fixed in 1.6.5 · GHSA-4h8q-hh2j-755w / CVE-2026-66004
- Code the AI is tricked into sending runs in Blender with your user's accessmedium · CVE-2026-10688
- The Hunyuan3D image option could be made to read and send local filesmedium · CVE-2026-10661
- A crafted model download link could make the server fetch internal network addressesmedium · CVE-2026-10662
Technical details
| Turning on read-only | No read-only mode. Safe mode (BLENDER_MCP_SAFE_MODE=1) blocks file access, running programs and network calls from AI scripts, but the AI can still change and delete anything in the Blender scene. |
|---|---|
| Talks to | Anonymous usage record to the project unless telemetry is off. Asset and AI generator services you switch on |
| Sign-in and keys | The Blender add-on's local socket has no login or encryption. |
| Data retention | Telemetry may be used to improve the project, for research and to train AI models. |
Alternatives
Use Blender's official Blender Lab MCP server if you run Blender 5.1 or newer, want the Claude Blender connector, or do not need asset libraries or AI model generation. Pick MCP for Blender for Poly Haven, Poly Pizza, AI model generators, or Blender versions before 5.1.
| Server | Official | Runs | Blender version | GitHub stars |
|---|---|---|---|---|
| For Blender | ||||
| MCP for BlenderThis page | Community | Local | 3.0+ | 32.9K |
| Other tools for the same job | ||||
| Blender Lab MCP | Official | Local | 5.1+ | – |
What people say
People like how well it works with current models and dislike how much it can do on your machine and how often Blender's official server is now the advice.
What people like
- Long-time users report months of use without problems.
- Users call it very effective with current models on Blender 5.2.
- Adds Poly Haven, Poly Pizza and AI model generators that Blender's own server lacks.
- Everyday modeling tasks cost about 16 to 23 cents each in one set of Claude Code runs.
Common complaints
- Some users now prefer Blender's official server, expecting better long-term support.
- Several Windows users on Blender 5.1 and 5.2 report every tool call hanging.
- Windows Defender flagged the one-line PowerShell installer as a trojan for one user.
- It lets the AI run any Python in Blender by default, with no login on the local socket.
In their words
“Kudos to the author for the unofficial blender-mcp add-on; I never had any problems.”Nick FisherGitHub issueSep 2026
“I'm using Astra with this mcp on 5.2.1. It's magic.”chadlyBlogMay 2026
“I just feel the official add-on is likely to be better supported going forward.”Nick FisherHacker NewsSep 2026
“You need to use the Blender MCP. There is an official plugin for this now, so the third party one can be avoided.”godwinson__4-8
2 more quotesFewer quotes
“in my case it turned out to be a port conflict. I had both this MCP and the official from BlenderLabs running, and they were competing for the same port. Uninstalling the official one fixed it for me.”laske185GitHub issueOct 2026
“Everyday tasks (describe the scene, build a table with four chairs, recolour them, check with a screenshot) took 69,000 to 126,000 input tokens and cost $0.16 to $0.23 each at API prices.”johnisking
Questions
How is MCP for Blender different from Blender's official MCP?
MCP for Blender is a community project by Siddharth Ahuja and says it is not made by Blender. Blender's developers publish their own server through Blender Lab, which is also the Claude Blender connector and needs Blender 5.1 or newer.
Can I use it alongside Blender's official MCP add-on?
Not at the same time on the default settings. Both add-ons listen on port 9876, and users report tool calls hanging until they disabled Blender Lab's add-on.
Is MCP for Blender free?
Yes. The add-on and server are free and MIT licensed. Premium ($10 to $100 a month) only covers AI 3D model generation without your own Meshy, Tripo, Hunyuan3D or Rodin keys.
Is MCP for Blender safe?
Only on your own machine. By default the AI can run any Python in Blender, and there are open reports of local file reading.
Can I stop the AI from running dangerous code?
Partly. Set BLENDER_MCP_SAFE_MODE=1 and each script is checked first, with file access, running programs and network calls blocked. Normal modeling, rendering and saving still work, and the AI can still delete things in your scene.
Does it collect my data?
By default it sends an anonymous usage record: tool name, success, timing, versions and OS. Prompts, code and screenshots are only sent if you opt in, and DISABLE_TELEMETRY=true turns everything off.
Which Blender version do I need?
Blender 3.0 or newer, with Python 3.10+ and uv. Some Windows users on Blender 5.1 and 5.2 report calls hanging, and one fix was removing a conflicting MCP add-on.
Do I need to change my config after the rename from blender-mcp?
No. The old blender-mcp package name still runs the server. New installs should use mcp-for-blender, and uvx mcp-for-blender setup switches old entries over.
Why do I get spawn uvx ENOENT?
Apps started from the Dock or Start menu do not see your terminal's PATH. Put the full path to uvx in the command, or on Windows use cmd /c uvx, then fully restart the app.
How much does a session cost in tokens?
About $0.16 to $0.23 per everyday task at API prices. In one user's Claude Code tests, tasks like building a table with four chairs took 69,000 to 126,000 input tokens each.
Examples
Build a themed low-poly scene from one sentence
Create a low poly scene in a dungeon, with a dragon guarding a pot of gold
SourceLight and texture a scene with free Poly Haven assets
Light the scene with an overcast afternoon HDRI and put a rusty metal texture on the wall
SourceRecreate a scene from a reference image
Give a reference image, and create a Blender scene out of it
SourceGenerate a 3D model with an AI generator
Generate a wooden rocking chair with Meshy
SourceFurnish a room with low-poly models
Search Poly Pizza for a low-poly chair under a CC0 licence and import one at 1 metre tall
SourceTurn a Blender scene into web code
Get information about the current scene, and make a threejs sketch from it
Source
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
mcp-for-blender- Registry
- PyPI
- Transport
- stdio
- Auth
- None
- Version
- 2.0.0
- License
- MIT
- Last commit
- Oct 29, 2026
- Open issues
- 32
Other Blender MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 37Hide
- MCP for Blender README · github.com
- MCP for Blender README · github.com
- Blender Lab MCP server · blender.org
- README: limitations and security · github.com
- README: safe mode · github.com
- README: telemetry · github.com
- README: environment variables · github.com
- Code execution with no login · github.com
- File read and URL fetch reports · github.com
- HN: maintainer account report · news.ycombinator.com
- Port clash · github.com
- GHSA-4h8q-hh2j-755w · github.com
- CVE-2026-10688 · nvd.nist.gov
- CVE-2026-10661 · nvd.nist.gov
- CVE-2026-10662 · nvd.nist.gov
- MCP for Blender premium · mcp-for-blender.com
- README: prerequisites · github.com
- Rename from blender-mcp · github.com
- README: make your client find uvx · github.com
- Tool-schema context cost · github.com
- README: client setup · github.com
- uvx picks Intel Python on Apple Silicon · github.com
- Setup command fails for Claude Code · github.com
- Scene-info validation error in Codex · github.com
- Timeouts and crashes in OpenCode · github.com
- Claude Code + Blender MCP · hydroxide.dev
- Is this the recommended blender mcp · github.com
- Tool calls hang on Windows · github.com
- Defender flags installer · github.com
- HN thread · news.ycombinator.com
- README: example commands · github.com
- README: Poly Haven · github.com
- README: Poly Pizza · github.com
- Claude for creative work · anthropic.com
- Claude Blender connector · dev.classmethod.jp
- README: capabilities · github.com
- README: troubleshooting · github.com