Blender MCP

Community

Open-source MCP server to connect Blender with any LLM for AI-assisted 3D modeling.

How to install ↓ Compare GitHub source repository ↗

Category: Dev Tools #133 of 438
Stars: ★ 30.4k Very popular
Transport: stdio (local process)
Runtime: Python 3.10+ · Docker
Credentials: Optional API key
License: MIT
Last commit: 5 days ago
Tools: 14

59FMRS · C

BlenderMCP is a feature-rich open-source project that provides a powerful bridge for LLM-Blender interaction and is well-received by the community. Its highlights include multiple external resource integrations and bidirectional communication, but the arbitrary code execution poses security risks that users should use with caution.

Strongest · Documentation 16/20 Weakest · Reliability 8/20

Reliability

8/20

Security and permissions

8/20

Maintenance

14/20

Documentation

16/20

Setup experience

13/20

Why each score

Reliability 8/20: Evidence is limited to the README; no manifest, tests, or CI files were supplied, so reproducibility cannot be verified. The architecture (Blender addon socket server + MCP stdio server) is described coherently and uses BLENDER_HOST/BLENDER_PORT env vars, suggesting controllable startup. Deductions: no committed tests or CI evidence; the README itself admits the first command sometimes fails ('Sometimes, the first command won't go through'), and the server depends on an external Blender process started manually, so errors are not fully controllable. Per static calibration, without verifiable execution evidence the score cannot exceed 12, hence 8.
Security and permissions 8/20: The main risk is execute_blender_code, which runs arbitrary Python inside Blender with potential host-side side effects (file read/write, network); README discloses it and warns to save work, but no explicit confirmation or sandboxing layer is described. Credentials (Sketchfab/Hyper3D/Hunyuan3D) are handled via add-on preferences or env vars, and install examples contain no real tokens — good. Telemetry is disclosed and controllable via DISABLE_TELEMETRY or a consent checkbox, but even 'no consent' still collects minimal usage data, and prompts/code snippets/screenshots are collected with consent — a partial data-boundary disclosure gap. External network use (Poly Haven, Sketchfab, Hyper3D, Hunyuan3D) is disclosed. Not a red-line finding since the behavior is disclosed core functionality, but permission/scoping is incomplete, hence 8.
Maintenance 14/20: MIT license, repository not archived, README references a releases page and changelog, has a sponsorship entry and Discord support channel; it documents ongoing feature additions (Hunyuan3D, Hyper3D, Poly Haven, remote host, telemetry), indicating an active project. Deductions: 95 open issues is high; no security-response channel or dependency-update evidence is visible; commit frequency and release cadence cannot be verified from the supplied material, hence 14.
Documentation 16/20: The README is layered and covers per-OS uv installation, multiple client configs (Claude Desktop/Code, Cursor, VS Code, OpenCode), addon install, env vars, usage with example commands, telemetry control, credential persistence, and a troubleshooting section including uvx ENOENT and first-command failures; security limitations are disclosed. Deductions: no tool-by-tool parameter reference (manifest not supplied), cost details are thin (only Hyper3D trial limits), and known erratic behavior such as Poly Haven is only briefly mentioned, hence 16.
Setup experience 13/20: The multi-component setup is clearly documented with per-client JSON examples and platform notes (macOS/Windows/Linux), plus PATH fixes and a pipx fallback, with good platform compatibility coverage. It remains manual and fragile: you must install uv, configure the client, download addon.py, install/enable it in Blender, and start the socket connection separately; known failure modes require manual workarounds. Per static calibration, no CI/tests exist in the supplied evidence, so the score is capped at 15; actual score 13.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessRuns commands or codeUses the network

Best for

3D artists and modelers who want to interact with Blender via natural language to boost productivity.
Developers looking to integrate Blender into AI-driven workflows.

Not for

Not suitable for automated environments that require strict security controls, as execute_blender_code allows arbitrary code execution.
Not ideal for users needing reliable real-time rendering or complex animations, as tools focus on scene creation and modification.

Required permissions

Network access to the Blender socket port (default 9876) for the MCP server.
Ability to execute arbitrary Python code, which can access the file system and other system resources.
External API keys (Sketchfab, Hyper3D, Hunyuan3D) for asset downloads and model generation.

Risks and side effects

The execute_blender_code tool can run arbitrary code, potentially causing data loss or system damage. Always save your work before using it.
Poly Haven integration may download large assets, consuming bandwidth and storage.
When running remotely, network connectivity may expose the server.
Third-party APIs may have usage limits or costs.

Setup

Before you start

Runtime：Python 3.10+ · Docker

BLENDERMCP_SKETCHFAB_API_KEY optionalsecret Sketchfab API key for searching and downloading Sketchfab models.

BLENDERMCP_POLYPIZZA_API_KEY optionalsecret Poly Pizza API key, free from poly.pizza/settings/api.

BLENDERMCP_HYPER3D_API_KEY optionalsecret Hyper3D Rodin API key for AI-generated 3D models.

BLENDERMCP_HUNYUAN3D_SECRET_ID optionalsecret Tencent Cloud Hunyuan3D SecretId from your Tencent Cloud account.

BLENDERMCP_HUNYUAN3D_SECRET_KEY optionalsecret Tencent Cloud Hunyuan3D SecretKey from your Tencent Cloud account.

Other optional settings (6)

BLENDER_HOST optional Host address of the Blender socket server, defaults to localhost; use host.docker.internal from Docker.

BLENDER_PORT optional Port of the Blender socket server, defaults to 9876; give each instance its own port when running several.

BLENDER_MCP_SAFE_MODE optional Set to 1 to validate scripts before they run in Blender and block risky code.

UV_PYTHON_PREFERENCE optional Set to only-managed so uv avoids conda/pyenv/system interpreters that can break installation.

DISABLE_TELEMETRY optional Set to true to fully disable anonymous usage telemetry.

BLENDERMCP_HUNYUAN3D_API_URL optional Hunyuan3D API endpoint URL, chosen by account region (mainland/international).

Install Blender 3.0 or later.
Install Python 3.10+ and the uv package manager.
Download the addon.py file from the repo, install and enable it in Blender via Edit > Preferences > Add-ons > Install...
Add the MCP server configuration to Claude Desktop's claude_desktop_config.json, using uvx to run blender-mcp.
In Blender, open the 3D View sidebar (press N), find the 'BlenderMCP' tab, and click 'Connect to Claude'.
Ensure the MCP server is running in your client.

claude_desktop_config.json

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["--python", "3.11", "blender-mcp"],
      "env": { "UV_PYTHON_PREFERENCE": "only-managed" }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "blender": {
      "command": "uvx",
      "args": [
        "--python",
        "3.11",
        "blender-mcp"
      ],
      "env": {
        "UV_PYTHON_PREFERENCE": "only-managed"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add blender -e UV_PYTHON_PREFERENCE=only-managed -- uvx --python 3.11 blender-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

Start the MCP server in Blender's MCP for Blender sidebar panel, then send a prompt from your AI client; if the blender server's tools (e.g. Get Scene Info) appear in the client's tool list and a 'get scene info' request returns real scene data, the connection works.

Troubleshooting

Connection issues: Ensure the Blender addon is enabled and 'Connect to Claude' is clicked, the MCP server is configured on the client, and do not run uvx command manually in terminal.
Timeout errors: Simplify requests or break them into smaller steps.
PATH issues: Make sure the client can find the full path to uvx, or wrap with cmd /c.
Python version conflicts: Use --python 3.11 and UV_PYTHON_PREFERENCE=only-managed.
Restart both client and server: fully quit and relaunch.

Things to try

Once connected, you can ask your AI assistant things like:

Get information about the current scene and list all objects
Create a low poly dungeon scene with a dragon guarding a pot of gold
Create a beach vibe using rocks and vegetation models from Poly Haven
Delete the selected object, then create a sphere placed above the cube

Tools 14

Get Scene Info read-only

Get detailed information about the current Blender scene.

Get Object Info read-only

Get attributes of a specified object.

Create Object writes

Create a new 3D object in the scene.

Modify Object writes

Modify properties such as position, rotation, scale of an object.

Delete Object destructive

Delete an object from the scene.

Apply Material writes

Apply an existing material to an object.

Create Material writes

Create a new material with properties like color.

Execute Blender Code writes

Execute arbitrary Python code in Blender (high risk).

Show 6 more tools

Search Sketchfab read-only

Search for 3D models on Sketchfab.

Download Sketchfab Model writes

Download a Sketchfab model into the Blender scene.

Load Poly Haven Asset writes

Load models, textures, or HDRIs from the Poly Haven API.

Generate Hyper3D Model writes

Generate 3D models via the Hyper3D Rodin API.

Generate Hunyuan3D Model writes

Generate 3D models via the Hunyuan3D API.

Capture Screenshot read-only

Capture a screenshot of the Blender viewport to understand the scene.

Use cases

Ask Claude to create complex 3D scenes from text prompts, like 'Create a low poly dungeon scene with a dragon guarding a pot of gold'.

Generate Blender scenes from reference images.

Use Poly Haven assets (HDRIs, textures, models) to create a beach vibe.

Generate 3D models via Hyper3D or Hunyuan3D.

Modify materials and lighting in existing scenes.

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

BlenderMCP is an open-source project that connects Blender to Claude AI via the Model Context Protocol (MCP), enabling Claude to directly interact with and control Blender. It supports scene creation, object manipulation, material control, Python code execution, and more. The system consists of a Blender addon (addon.py) that serves as a socket server, and an MCP Python server. Tools include fetching scene/object info, creating/modifying/deleting objects, applying materials, executing arbitrary Python code, and integrating external resources like Sketchfab, Poly Haven, and Hyper3D. Installation requires Blender 3.0+, Python 3.10+, and the uv package manager.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

NPM Sentinel MCP Server 79 · B

AI-powered NPM package analysis MCP server

★ 18 · Tools 19 Compare with this →

MartinLoop MCP Server 79 · B

An independent control layer that gives AI coding agents budgets, brakes, and receipts

★ 409 Compare with this →

GitHub MCP Server 76 · B

GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language

★ 33.5k · Tools 15 Compare with this →

Compare with other MCP servers

Source revision 7a0373ec9199 Data synced 2026-10-11 Read the FMRS scoring method