Log inSubmit server
Blender MCP logo

Blender MCP

by ahujasid

Connects an MCP-compatible AI client to Blender for scene editing, Python execution, visual checks, and 3D asset workflows.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Blender MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ahujasid-blender-mcp": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

ahujasid/blender-mcp connects an MCP client to Blender through a Blender addon and a socket-based connection. It lets an AI inspect scenes, execute Blender Python, capture viewport screenshots, query Blender API and node schemas, and manipulate objects and materials. Asset workflows cover Poly Haven, Sketchfab, Poly Pizza, Hyper3D Rodin, and Hunyuan3D when the corresponding Blender integrations are enabled. Reach for it when an agent needs to create, inspect, modify, or populate Blender scenes through natural-language tasks.

Use cases

  • Create and modify Blender scenes from natural-language instructions
  • Inspect objects and validate scene changes with viewport screenshots
  • Generate Blender Python using API and node schema lookups
  • Populate scenes with downloadable or AI-generated 3D assets

Key features

  • Blender scene and object inspection
  • Arbitrary Blender Python execution
  • Viewport screenshot capture
  • RNA, API, and node schema lookup
  • Poly Haven, Sketchfab, and Poly Pizza asset workflows
  • Hyper3D Rodin and Hunyuan3D generation

Tools32

What Blender MCP lets your agent do. Expand a tool for its parameters.

Verified live~8.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

29/30 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 1Low 1

Scanned 8d ago via OSV.dev · blender-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars32kStargazers on the source repository.
Last commit3d agoMost recent push to the default branch.
Tools exposed32Callable tools this server registers over MCP.
Directory activity11 viewsConfig copies, upvotes, and views on AllMCPs.

How Blender MCP works

What ahujasid/blender-mcp does

ahujasid/blender-mcp exposes Blender operations through MCP so an AI client can work with an open Blender session. The Blender side is an addon that starts a socket server; the Python MCP server receives tool calls and forwards commands to that addon.

Core workflows include reading scene and object details, running arbitrary Blender Python, inspecting the 3D viewport, and checking Blender's RNA/API structures. Agents can also create, modify, and delete objects, control materials and colors through executed Blender code, and use screenshots or rendered views for visual verification.

The server extends Blender with optional asset services. It can search, preview, download, and import Poly Haven assets; search and import downloadable Sketchfab models; search and import Poly Pizza models; and generate assets through Hyper3D Rodin or Hunyuan3D. Status tools report whether Poly Haven, Sketchfab, Poly Pizza, Hyper3D Rodin, or Hunyuan3D features are available.

How it works

The system has two components: the MCP server and the Blender addon. The addon must be installed and enabled in Blender, and it starts its server when Blender opens. In the Blender interface, the MCP for Blender panel can be used to start the server if it is not already running.

Most tools accept the user's original prompt so a sequence of operations can remain linked to the same goal. Blender code is sent to the running application for execution. Asset generation services may use asynchronous jobs: the agent starts generation, polls for completion, and then imports the resulting asset.

Asset tools include safeguards and selection steps. Poly Haven searches return categories, attributes, sizes, and ranked results; previews can be retrieved before downloading. Sketchfab models can also be previewed before import. Imported Sketchfab and Poly Pizza models can be normalized to a requested largest dimension, while generated assets may need additional rescaling.

Setup and configuration

Automatic setup is available through the installer scripts for macOS, Linux, and Windows, or through uvx mcp-for-blender setup when uv is already installed. The setup process can configure supported MCP clients, install the Blender addon, and enable it. New installations should use the mcp-for-blender package name; the older blender-mcp invocation remains compatible with existing setups.

Manual setup requires Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. Add the server to the MCP client with uvx mcp-for-blender, then install the addon with uvx mcp-for-blender install-addon. In Blender, enable Interface: MCP for Blender under Edit → Preferences → Add-ons. Fully restart the AI client after configuration, then open Blender and confirm that the MCP server is running.

Only one MCP server instance should be running for the connection, rather than starting separate instances for multiple clients.

Tools and capabilities

  • Inspect the current scene or a named object.
  • Execute arbitrary Python code inside Blender.
  • Capture a 3D viewport screenshot with a configurable maximum dimension.
  • Query Blender RNA types, properties, methods, operators, signatures, enums, defaults, and suggested matches.
  • Inspect the sockets and properties of a Blender node type without changing the visible scene.
  • Check addon version compatibility and control telemetry opt-out.
  • Search, preview, download, and import Poly Haven HDRIs, textures, and models.
  • Apply a downloaded Poly Haven texture to an object.
  • Search, preview, and import downloadable Sketchfab models with a target size.
  • Search and import Poly Pizza models with optional licence, category, animation, and size controls.
  • Generate and import models through Hyper3D Rodin or Hunyuan3D, including polling tools for asynchronous jobs.

Limitations and notes

The Blender addon is required for scene operations, and integrations such as Poly Haven, Sketchfab, Hyper3D Rodin, and Hunyuan3D depend on their corresponding features being enabled in Blender. Sketchfab imports require the model to be downloadable and accessible to the user. Hyper3D image generation requires either absolute local image paths or image URLs according to the active Rodin mode.

execute_blender_code runs arbitrary Python in Blender, so generated code should be reviewed when the task is sensitive. The set_texture operation replaces every existing material slot on its target object and cannot be undone. Poly Pizza assets can have arbitrary source scale and origins; normalization with a real-world target size is available for imports.

Telemetry can be disabled immediately with disable_telemetry. That tool only turns collection off; re-enabling it is done by the user in Blender under Preferences → Add-ons → Blender MCP. The addon can collect prompts, code, screenshots, and scene data when telemetry is enabled.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Blender MCP

ahujasid/blender-mcp is an MCP server that connects an MCP client to Blender through a Blender addon and socket-based communication. Its main tools inspect scenes and objects, execute Blender Python, capture viewport images, look up Blender APIs and nodes, and search, preview, generate, download, and import 3D assets.

Install `uv`, run `uvx mcp-for-blender setup`, and follow the client and addon prompts. For manual setup, add `uvx mcp-for-blender` to the MCP client, run `uvx mcp-for-blender install-addon`, enable **Interface: MCP for Blender** in Blender, and restart the AI client.

Yes, Cursor is among the clients supported by the setup flow. The automatic setup can find Cursor and add the Blender server configuration, or you can configure it manually using the MCP client setup instructions and the `uvx mcp-for-blender` command.

Search and preview an asset first, then call the matching download or generation tool and import it into Blender. Supported workflows include Poly Haven, Sketchfab, Poly Pizza, Hyper3D Rodin, and Hunyuan3D; some generated assets require polling before the import step.

Related MCP servers

All in Architecture & Design All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBlender MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ahujasid-blender-mcp?style=directory)](https://allmcps.com/mcp/ahujasid-blender-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/ahujasid-blender-mcp"><img src="https://allmcps.com/api/badge/ahujasid-blender-mcp?style=directory" alt="Blender MCP on AllMCPs" /></a>