Blender MCP — Use Cases, Install & Live Demo

Name: Blender MCP MCP Server
Author: ahujasid

Why use it

Key features

Direct bpy execution — anything you can script, Claude can drive
Scene introspection: list objects, get properties, inspect materials
PolyHaven integration: search and import HDRIs, textures, models
Hyper3D rodin: AI-generate 3D models from text or image
Sketchfab search built in for free model browsing

Live Demo

What it looks like in practice

blender-mcp-ahujasid.replay ▶ ready

0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "blender-mcp-ahujasid",
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json

{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Blender MCP

Build a 3D scene from a text prompt without touching the Blender UI

👤 Designers, indie devs, hobbyists who can't model fluently ⏱ ~30 min beginner

When to use: You want a quick 3D scene mockup but don't want to learn Blender shortcuts.

Prerequisites

Blender 3.0+ installed — Download from blender.org
Blender MCP addon enabled — Edit > Preferences > Add-ons > Install from disk

Flow

Connect Claude to Blender

Open Blender. In the N-panel, click 'Connect to Claude'. Verify connection in chat by listing scene objects.✓ Copied

→ Empty scene listed (Cube, Camera, Light) confirming live connection
Compose the scene

Build a low-poly forest clearing: 5 trees in a circle, a campfire in the center, a sleeping bag nearby. Use simple geometry.✓ Copied

→ Objects appear in viewport in real time
Add atmosphere

Search PolyHaven for a sunset HDRI. Apply it. Then add a small fog volume above the ground.✓ Copied

→ Scene now has lit atmosphere; fog visible in render

Outcome: A prototype 3D scene built entirely through chat, ready for refinement.

Pitfalls

Blender disconnects mid-session — Reconnect from the N-panel; the addon listens on a local socket

Generate 3D assets with Hyper3D rodin and import directly

👤 Game devs and prototypers needing fast asset iteration ⏱ ~20 min intermediate

When to use: You need a unique prop and don't want to model from scratch or pay for marketplace assets.

Prerequisites

Hyper3D rodin API key (free tier available) — Sign up at hyper3d.ai; set HYPER3D_RODIN_API_KEY

Flow

Generate from prompt

Generate a stylized treasure chest with iron bands using Hyper3D rodin. Import it at origin.✓ Copied

→ Generation job spins up; mesh imported when done (~30s)
Refine and re-import if needed

The mesh is too dense. Decimate to 5k tris and reimport.✓ Copied

→ Decimated mesh replaces original

Outcome: Custom 3D prop in scene, generated and tuned without leaving Claude.

Pitfalls

Generation queue is busy on free tier — Retry with exponential backoff or upgrade tier

Run batch operations across many objects via bpy

👤 TDs and pipeline engineers ⏱ ~25 min advanced

When to use: You need a tedious bulk action — rename hierarchy, retarget materials, batch UV unwrap.

Flow

Describe the operation

Every object starting with 'prop_' should be moved into a 'Props' collection and have its origin set to geometry center.✓ Copied

→ Claude writes the bpy snippet, asks to confirm before running
Run with safety net

Show me the script first. If it looks safe, execute. Otherwise revise.✓ Copied

→ Script visible; execution applied; report of how many objects affected

Outcome: Bulk scene operations done in seconds with full audit trail.

Pitfalls

Bad script crashes Blender — Save before any bpy execution; the addon doesn't sandbox

Combinations

Pair with other MCPs for X10 leverage

blender-mcp-ahujasid + filesystem

Save renders and exports to disk

After rendering, save the PNG to ~/Renders/today.png via filesystem MCP.✓ Copied

Tools

What this MCP exposes

Tool	Inputs	When to call	Cost
execute_blender_code	code: str	Any direct bpy operation	0
get_scene_info	()	First call to understand what's in the scene	0
get_object_info	name: str	Inspect a specific object before editing	0
polyhaven_search_assets	asset_type: hdri\|model\|texture, categories?	Find free PBR assets	0
polyhaven_download_asset	asset_id, resolution	Pull and apply HDRI/texture	0
generate_hyper3d_model_via_text	prompt: str	AI-generate a 3D model	1 generation credit

Cost & Limits

What this costs to run

API quota: PolyHaven: unlimited free. Hyper3D: free tier ~20 generations/day
Tokens per call: 100–800 per call (scene state can be verbose)
Monetary: Free addon. Hyper3D paid tiers from $10/mo
Tip: Use Sketchfab and PolyHaven before paying for Hyper3D generations

Security

Permissions, secrets, blast radius

Minimum scopes: blender-bpy-exec filesystem-write (for downloads)

Credential storage: Hyper3D key in env var

Data egress: PolyHaven CDN, Hyper3D API

execute_blender_code runs arbitrary Python in your Blender — review before running unknown scripts

Troubleshooting

Common errors and fixes

Connection refused

Make sure Blender is open and the addon's 'Connect to Claude' is on; default port 9876

Hyper3D generation hangs

Check HYPER3D_RODIN_API_KEY env var; check tier quota at hyper3d.ai

Object not found after edit

Object name may have a numeric suffix (.001) — use get_scene_info to refresh

Alternatives

Blender MCP vs others

Alternative	When to use it instead	Tradeoff
Unity MCP / Unreal MCP	Your pipeline is game engine first, not DCC	Engine MCPs target runtime/scene; Blender MCP targets authoring
Cesium MCP	You need geospatial/world-scale 3D	Cesium is for georeferenced scenes; Blender is freeform

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills