PlugWiki
MCP for Blender logo

MCP for Blender, the community Blender MCP server

CommunityLocal
GetPyPImcp-for-blenderahujasid/mcp-for-blenderDocs

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.

Install MCP for Blender

Claude Code

  1. 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. 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_info

  • Takes 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 · look

  • Finds 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_assets

  • Shows 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_status

  • Runs 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_code

  • Brings 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_asset

  • Generates 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_3d

  • Turns off anonymous usage data collection

    One of the data collection controls.

    Try: “Turn off telemetry for the Blender plugin”

    Write · disable_telemetry

  • Records 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

Technical details
Turning on read-onlyNo 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 toAnonymous usage record to the project unless telemetry is off. Asset and AI generator services you switch on
Sign-in and keysThe Blender add-on's local socket has no login or encryption.
Data retentionTelemetry 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.

ServerOfficialRunsBlender versionGitHub stars
For Blender
MCP for BlenderThis pageCommunityLocal3.0+32.9K
Other tools for the same job
Blender Lab MCPOfficialLocal5.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

2 more quotes

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

    Source
  • Light 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

    Source
  • Recreate a scene from a reference image

    Give a reference image, and create a Blender scene out of it

    Source
  • Generate a 3D model with an AI generator

    Generate a wooden rocking chair with Meshy

    Source
  • Furnish 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

    Source
  • Turn 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

WebsiteDocsGitHubPyPIPricingIssues

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 37
  1. MCP for Blender README · github.com
  2. MCP for Blender README · github.com
  3. Blender Lab MCP server · blender.org
  4. README: limitations and security · github.com
  5. README: safe mode · github.com
  6. README: telemetry · github.com
  7. README: environment variables · github.com
  8. Code execution with no login · github.com
  9. File read and URL fetch reports · github.com
  10. HN: maintainer account report · news.ycombinator.com
  11. Port clash · github.com
  12. GHSA-4h8q-hh2j-755w · github.com
  13. CVE-2026-10688 · nvd.nist.gov
  14. CVE-2026-10661 · nvd.nist.gov
  15. CVE-2026-10662 · nvd.nist.gov
  16. MCP for Blender premium · mcp-for-blender.com
  17. README: prerequisites · github.com
  18. Rename from blender-mcp · github.com
  19. README: make your client find uvx · github.com
  20. Tool-schema context cost · github.com
  21. README: client setup · github.com
  22. uvx picks Intel Python on Apple Silicon · github.com
  23. Setup command fails for Claude Code · github.com
  24. Scene-info validation error in Codex · github.com
  25. Timeouts and crashes in OpenCode · github.com
  26. Claude Code + Blender MCP · hydroxide.dev
  27. Is this the recommended blender mcp · github.com
  28. Tool calls hang on Windows · github.com
  29. Defender flags installer · github.com
  30. HN thread · news.ycombinator.com
  31. README: example commands · github.com
  32. README: Poly Haven · github.com
  33. README: Poly Pizza · github.com
  34. Claude for creative work · anthropic.com
  35. Claude Blender connector · dev.classmethod.jp
  36. README: capabilities · github.com
  37. README: troubleshooting · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.