MCP for Blender: Control Blender scenes with any LLM through natural language
An MCP addon that lets Claude and other LLMs control Blender, fetch assets, and generate 3D models.
GitHub ahujasid/mcp-for-blender Updated 2026-09-30 Branch main Stars 29.7K Forks 2.7K
Python MCP Blender Claude Hyper3D Rodin Hunyuan3D Docker

🧭 Decision Guide

Why trending now: Cannot be determined from the provided materials

Try it if you

  • You want Claude to create Blender objects, materials, or complete scenes using natural-language prompts.
    The README sections Features and Usage → Example Commands list object manipulation, material control, and scene-creation examples.
  • You need assets from Poly Haven, Sketchfab, Poly Pizza, or Hyper3D Rodin.
    The README section Features → Asset & model generation explicitly lists these asset sources.
  • Your environment supports uvx and can install the Interface: MCP for Blender addon in Blender.
    The README Quickstart requires installing uv, configuring an MCP client, and installing the Blender addon.
  • You want to put the MCP server in Docker while keeping Blender running on the host machine.
    The README section Installation → Run with Docker says the container hosts only the MCP server while Blender runs on the machine.

Skip it if you

  • Your environment cannot install uv, pipx, or Docker and cannot manually install Blender's addon.py.
    The README provides only uv, pipx, Docker, and manual addon.py installation paths.
  • Your workflow cannot allow Claude to execute arbitrary Python code.
    The README Features → Code execution explicitly says Claude can run arbitrary Python code in Blender.
  • Blender must remain responsive while downloading high-resolution Poly Haven assets.
    The README Troubleshooting section says Poly Haven assets download on Blender's main thread and the UI stops responding during the transfer.
  • Your Poly Pizza requests can only originate from datacenter, VPN, or cloud IPs.
    The README Troubleshooting section says static.poly.pizza's Cloudflare protection blocks those IPs.

Requirements

  • Install uv; the README warns against pip install uv and requires the official installer.
  • Configure an MCP client such as Claude Desktop, Claude Code, or Codex.
  • Enable Interface: MCP for Blender in Blender, then press N in the 3D viewport to open the MCP for Blender tab.
  • Click Start MCP Server to connect; the README requires running only one MCP server instance.
  • Using Sketchfab, Poly Pizza, Hyper3D, or Hunyuan3D requires the corresponding API key, SecretId/SecretKey, or API URL.
  • The Docker option requires building the mcp-for-blender image; Linux also requires --network=host and BLENDER_HOST=localhost.

First step (verbatim from README)

uvx mcp-for-blender install-addon

Watch out

  • New installations should use mcp-for-blender; the old command uvx blender-mcp still works without configuration changes.
    The README Quickstart package rename note.
  • Do not run the uvx command directly in a terminal when troubleshooting connection issues.
    README Troubleshooting → Connection issues explicitly says Do not run the uvx command in the terminal.
  • Each increase in Poly Haven resolution makes the file roughly four times larger.
    README Troubleshooting → Blender freezes during a Poly Haven download.
  • Docker client arguments must include -i because the server communicates with the client over stdin/stdout.
    README Installation → Run with Docker.
  • Claude Desktop and Cursor must not start two MCP server instances at the same time.
    README Quickstart → Connect requires running only one MCP server instance.

Alternatives

  • Blender Python API：Better when you need a fully deterministic scripted modeling workflow without an MCP client or LLM interaction.
    General domain knowledge
  • Install mcp-for-blender with pipx：Better when the locked-down environment cannot use uvx but can use pipx.
    README Installation → Install without uv
  • Run mcp-for-blender with Docker：Better when you want to isolate the MCP server installation while Blender continues running on the host.
    README Installation → Run with Docker

Not stated in the README

  • The materials do not provide a supported Blender version and complete operating-system matrix.
  • The materials do not specify compatibility versions or the actual compatibility range for LLM clients beyond Claude, Codex, Cursor, VS Code, and the listed clients.
  • The materials do not describe permission boundaries, isolation, or default safe-mode behavior for arbitrary Python execution.
  • The materials do not provide pricing, quotas, or service availability for Hyper3D, Hunyuan3D, Sketchfab, or Poly Pizza.
  • The materials do not provide performance benchmarks such as supported scene size, model-generation time, or concurrency limits.
  • The repository has no releases, and the materials do not describe a stable-version policy; metadata shows 10 contributors and 10 recent commits.
  • The materials do not explain whether the 2026-09-30 update changed functionality, and the Trending reason cannot be determined from the README alone.

💡 Deep Analysis

6
No I have configured mcp-for-blender in both Cursor and Claude Desktop and want both clients to operate on the same Blender scene; does this project support running them simultaneously?
For: A Blender automation developer using both Cursor and Claude Desktop who wants both clients to control the same local scene

No, not in the simultaneous configuration you described, because the README explicitly requires only one MCP server instance; two clients may create connection or state conflicts.

  • The Quickstart / Connect section says: “Only run one instance of the MCP server (either Cursor or Claude Desktop), not both.”
  • The project uses a socket-based server and two-way communication with the Blender addon, so multiple server instances are not separate safe sessions.
  • Cursor and Claude Desktop are both supported MCP clients, but supporting two clients does not mean two server instances may run concurrently.
  • If your workflow requires switching between clients, the README does not describe scene locks, request arbitration, session isolation, or state recovery, so it should not be treated as a concurrent dual-client control system.
  • README / Quickstart / Connect: "Only run one instance of the MCP server (either Cursor or Claude Desktop), not both."
  • README / Features: "Two-way communication ... through a socket-based server"
  • README / Quickstart: Cursor, VS Code, OpenCode, Antigravity, and Claude Desktop are listed as client paths
Not stated in the README：The README does not describe a supported coordination method for multiple MCP clients behind one server instance.；The README does not define how Blender scene state is recovered after conflicting requests.
It depends I want to run the MCP server in Docker on Linux while the Blender addon remains on the host at localhost; can I connect the two sides using this project's deployment method?
For: An automation developer on Linux who wants to run the MCP server in Docker while Blender remains on the host and must handle container-to-localhost connectivity

It depends, because the project supports this architecture, but Linux cannot use Docker’s default host.docker.internal; host networking and the correct BLENDER_HOST are required.

  • The Docker section says that the container hosts only the MCP server while Blender continues running on the local machine.
  • The README explicitly states that host.docker.internal does not exist on Linux and that the addon listens only on localhost.
  • The Linux configuration requires --network=host and BLENDER_HOST=localhost; omitting either can prevent the connection.
  • The client communicates with the container over stdin/stdout, so the Docker configuration must retain -i rather than running only a detached container.
  • README / Run with Docker: "Blender itself still runs on your machine"
  • README / Run with Docker: "On Linux, host.docker.internal doesn't exist"
  • README / Run with Docker / Linux configuration: `--network=host` and `-e`, `BLENDER_HOST=localhost`
  • README / Run with Docker: "The -i flag is required"
docker build -t mcp-for-blender .
Not stated in the README：The README does not explain how Linux firewalls, SELinux, or enterprise container policies affect host networking.；The README does not provide a validation list for specific Docker and Blender version combinations.
Yes My workstation is a locked-down machine where uvx is unavailable, but pipx is allowed. I also need to connect the server to Claude Desktop or Cursor; does this project fit that installation constraint?
For: A Python tools developer running Blender on a locked-down workstation who cannot rely on uvx and wants to install the MCP server with pipx

Yes, because the README explicitly provides a pipx path that avoids uvx; however, the client must point to the absolute command installed by pipx.

  • Installation / Install without uv explicitly says that locked-down machines can skip uvx and install mcp-for-blender with pipx.
  • The README requires running pipx ensurepath, then restarting the shell or client, and locating the executable with which mcp-for-blender or where mcp-for-blender.
  • With pipx, the client configuration must use the resulting absolute path as command and omit args, unlike the default uvx mcp-for-blender configuration.
  • The Blender addon still has to be installed and enabled separately, so pipx only addresses MCP server deployment, not the Blender-side component.
  • README / Installation / Install without uv: "On locked-down machines you can skip uvx entirely with pipx"
  • README / Installation / Install without uv: "Use the resulting absolute path as \"command\" ... and omit args."
  • README / Installing the Blender Addon: `uvx mcp-for-blender install-addon`
pipx install mcp-for-blender
Not stated in the README：The README does not state whether organizational proxies, internal PyPI mirrors, or offline environments are supported.；The README does not provide a compatibility matrix for Blender versions and addon directories under pipx.
It depends I already write Blender automation scripts in Python and want Claude Code to execute arbitrary Blender Python through MCP; is this project suitable for production workflows containing important project files?
For: A Python developer maintaining Blender automation workflows who wants an MCP client to execute arbitrary Blender Python code directly

It depends: the project is well suited to extending Blender Python automation, but it should not be given unrestricted access to important production files through unreviewed model output or requests.

  • The Features section explicitly provides Code execution, allowing Claude to run arbitrary Python in Blender and offering broader coverage than fixed object-operation tools.
  • The README includes Safe mode and Limitations & Security Considerations sections, indicating that the security boundary requires separate handling rather than being automatically guaranteed by MCP.
  • Project insights state that erroneous or destructive scripts may modify or delete scene content and access resources that should not be exposed.
  • Project data shows no latest release and release_count is 0; if your production workflow requires strict version pinning and change auditing, the current repository state adds governance uncertainty.
  • README / Features: "Code execution | Run arbitrary Python code in Blender from Claude"
  • README sections: Safe mode and Limitations & Security Considerations
  • Project insights / usage_limitations: arbitrary Python execution creates significant security risk
  • Project data: latest_release is empty, release_count is 0, and main_language is Python
claude mcp add blender uvx mcp-for-blender
Not stated in the README：The README does not specify which Python operations Safe mode blocks or provide a complete permission model.；The README does not identify a stable commit, version tag, or production support lifecycle for the current code.
Yes I am new to Blender and use Claude Desktop. I want to create scenes such as a low-poly dungeon with prompts, including modeling and lighting; is this project suitable for me?
For: An independent creator using Claude Desktop, new to Blender, who wants to create low-poly scenes through natural language

Yes, because it connects Claude Desktop to a local Blender instance and lowers the barrier to object, material, and lighting operations, although it does not replace basic Blender knowledge.

  • The README Features section lists object creation, modification, deletion, material control, and scene inspection.
  • The Usage examples include “Create a low poly scene in a dungeon…” and studio-style lighting, which directly match your goal.
  • Quickstart requires configuring the MCP client, installing the Blender addon, and clicking Start MCP Server in the 3D viewport; installing a chat tool alone is not enough.
  • The project can execute arbitrary Python inside Blender, so complex prompts may alter scene structure and beginners still need to judge whether the result is correct.
  • README / Features: Object manipulation, Material control, Scene inspection, Code execution
  • README / Usage / Example Commands: "Create a low poly scene in a dungeon, with a dragon guarding a pot of gold"
  • README / Quickstart: "In Blender's 3D viewport, press N ... click Start MCP Server"
uvx mcp-for-blender install-addon
Not stated in the README：The README does not specify compatibility details for different Blender versions.；The README does not quantify success rate, response time, or output quality for complex scene prompts.
Yes I need to combine Poly Haven, Sketchfab, and Poly Pizza assets in Blender concept scenes and call Hyper3D Rodin or Hunyuan3D for generated models; can this project reduce switching between tools?
For: A concept designer who needs assets from Poly Haven, Sketchfab, and Poly Pizza and model generation through Hyper3D Rodin or Hunyuan3D

Yes, for concept design and rapid prototyping, because the README presents asset retrieval, import, and AI 3D model generation as one Blender-oriented workflow; third-party service conditions still determine actual availability.

  • Features explicitly lists Poly Haven, Sketchfab, Poly Pizza, Hyper3D Rodin, and Hunyuan3D.
  • The Usage examples include retrieving HDRIs, textures, rocks, and vegetation from Poly Haven, as well as filling a room with low-poly furniture from Poly Pizza.
  • The README also gives a Hyper3D example for generating a garden gnome, showing that the workflow covers more than static asset downloads.
  • Project insights indicate that these capabilities depend on API credentials, network access, and third-party service limits; the project centralizes the workflow in Blender but does not guarantee licensing, service availability, or uniform model quality.
  • README / Features / Asset & model generation: Poly Haven, Sketchfab, Poly Pizza, Hyper3D Rodin, and Hunyuan3D
  • README / Usage / Example Commands: "Create a beach vibe using HDRIs, textures, and models like rocks and vegetation from Poly Haven"
  • README / Usage / Example Commands: "Fill this room with low-poly furniture from Poly Pizza"
  • README / Usage / Example Commands: "Generate a 3D model of a garden gnome through Hyper3D"
uvx mcp-for-blender install-addon
Not stated in the README：The provided README content does not list the complete licensing and commercial-use restrictions for each asset source.；The README does not specify API pricing, quotas, regional availability, or output-format differences for Hyper3D Rodin and Hunyuan3D.

✨ Highlights

  • Connects any LLM to Blender with two-way communication
  • Creates objects, modifies materials, and inspects Blender scenes
  • Integrates Poly Haven, Sketchfab, and Hyper3D models
  • Code execution lets Claude run arbitrary Python code

🔧 Engineering

  • Install the MCP server and Blender addon with uvx mcp-for-blender
  • Use Claude to control objects, materials, scenes, and Python code
  • Generate 3D models with Hyper3D Rodin and Hunyuan3D

⚠️ Risks

  • Code execution supports running arbitrary Python code from Claude
  • Poly Haven downloads block Blender's main thread and UI
  • Linux Docker requires host networking and BLENDER_HOST configuration
  • The Poly Pizza CDN blocks datacenter, VPN, and cloud IPs

👥 For who?

  • Developers creating AI-assisted 3D scenes with Claude and Blender
  • Python teams that need to drive Blender through an MCP client
  • Users who want Docker-hosted MCP while Blender runs locally