Blender MCP Pro

Control Blender entirely from AI assistants (Claude Code, Claude Desktop, Cursor, Windsurf) via MCP.

120+ tools across 17 categories — Scene management, materials, shader nodes, lights, modifiers, animation, geometry nodes (with scatter/array templates), camera, rendering, import/export, UV/texture, batch processing, asset integration (Poly Haven, Sketchfab), rigging, rig diagnostics, scene utilities, workflow presets, and code execution.

Pricing

	Subscription	One-Time Purchase
Price	$5/month (7-day free trial)	$15
Platform	Gumroad	itch.io
Updates	Included while subscribed	Lifetime updates

Get Started

Purchase on itch.io ($15 one-time) or subscribe on Gumroad ($5/month with 7-day free trial)
Download the ZIP containing the MCP server and this addon
Follow the setup instructions below

Requirements

Blender 4.0+ (5.0 recommended)
Python 3.10+ (for the MCP server)
MCP-compatible client (Claude Code / Claude Desktop / Cursor / Windsurf)

Installation

1. Install MCP server dependencies

cd server
pip install -r requirements.txt

2. Install the Blender addon

Open Blender → Edit > Preferences > Add-ons > Install
Select the addon/ folder from the downloaded ZIP
Enable "Blender MCP Pro"
Open the 3D Viewport sidebar (N key) → BM Pro tab → Start Server

3. Configure your MCP client

Add the following to your MCP client config. Replace <path> with the actual path where you extracted the ZIP.

Claude Code (`~/.claude.json`)

{
  "mcpServers": {
    "blender-mcp-pro": {
      "command": "python",
      "args": ["<path>/server/server.py"],
      "env": {
        "BLENDER_MCP_PRO_LICENSE": "YOUR-LICENSE-KEY"
      }
    }
  }
}

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "blender-mcp-pro": {
      "command": "python",
      "args": ["<path>/server/server.py"],
      "env": {
        "BLENDER_MCP_PRO_LICENSE": "YOUR-LICENSE-KEY"
      }
    }
  }
}

Cursor / Windsurf

Add server/server.py in your MCP settings with the BLENDER_MCP_PRO_LICENSE environment variable.

Updating

When a new version is released:

Download the latest ZIP from your Gumroad library or itch.io
Extract and overwrite the existing server/ folder
In Blender: Edit > Preferences > Add-ons → remove the old "Blender MCP Pro"
Install the new addon/ folder and enable it
Restart Blender

Your MCP client config and license key do not need to change.

Usage

Start the addon server in Blender (N panel → BM Pro → Start Server)
Launch your MCP client (e.g., Claude Code)
Control Blender with natural language!

Streamable HTTP Transport (optional)

By default, the MCP server uses stdio transport. For remote connections or web-based clients, you can use Streamable HTTP:

python server/server.py --transport streamable-http --port 8000

Then configure your MCP client to connect to http://127.0.0.1:8000/mcp/.

Examples

"Create a Suzanne and add SubSurf and Bevel modifiers"
"Create a glass material and apply it"
"Set up three-point lighting"
"Set the camera to 85mm lens and track the object"
"Add a rotation animation"
"Render at 1920x1080 with Cycles"

Architecture

AI Assistant (Claude / Cursor / Windsurf)
    │
    │ MCP Protocol (stdio)
    ▼
MCP Server (server.py)
    │
    │ TCP Socket (localhost:9877)
    ▼
Blender Addon (this repo)
    │
    │ bpy API (main thread)
    ▼
Blender

Tool Categories

Category	Description
Scene & Objects	Create, transform, delete objects, manage collections
Materials	Principled BSDF material setup
Shader Nodes	Full node tree control
Lights	Point/Sun/Spot/Area, three-point lighting
Modifiers	22 modifier types (SubSurf, Bevel, Boolean, Array...)
Animation	Keyframes, interpolation, actions, NLA
Geometry Nodes	Build node networks, scatter setup, array along curve
Camera	Lens, DOF, tracking, auto-framing
Render	Engine settings, render to file, viewport screenshot
Import/Export	FBX, OBJ, GLTF/GLB, USD, STL, DAE, PLY, SVG, ABC
UV & Texture	7 unwrap methods, texture baking
Batch Processing	Multi-camera render, turntable
Assets	Poly Haven, Sketchfab integration
Rigging	Armature, bones, vertex groups, constraints
Rig Diagnostics	Rig health check, bone naming fix, weight normalization, bone mirroring
Scene Utilities	Scene cleanup, batch rename, apply transforms, mesh analysis
Workflows	One-command PBR material, studio render setup, export preparation

Lazy Loading

Only 15 core tools are loaded initially. Use list_tool_categories() to see all categories, then enable_tools(category) to activate on demand.

Eager mode (for clients without `tools/list_changed` support)

Some MCP clients — notably VS Code GitHub Copilot Chat — ignore the notifications/tools/list_changed message that enable_tools() sends, so newly activated tools never become visible in the tool picker. If you hit this, launch the server with BLENDER_MCP_PRO_EAGER=1 to pre-register every category at startup:

{
  "mcpServers": {
    "blender-mcp-pro": {
      "command": "python",
      "args": ["<path>/server.py"],
      "env": {
        "BLENDER_MCP_PRO_LICENSE": "YOUR-LICENSE-KEY",
        "BLENDER_MCP_PRO_EAGER": "1"
      }
    }
  }
}

Claude Desktop and Claude Code handle list_changed correctly and do not need this flag.

License

Blender Addon (addon/) — MIT License
MCP Server — Proprietary. Distributed via Gumroad and itch.io.

Author

@youichi-uda

blender-mcp-pro