Blender

Provides two-way control of Blender via MCP for scene creation, object manipulation, materials, and Python execution.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shirshovdim-retopoflow_blender_mcp": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ],
      "env": {
        "BLENDER_HOST": "localhost",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

BlenderMCP links Blender to Claude AI through the Model Context Protocol, enabling prompt-driven 3D modeling, scene creation, and live control of Blender from the MCP client. You can inspect your scene, generate models, adjust materials, run Python code inside Blender, and manage retopology workflows directly from Claude or your MCP-compatible client.

How to use

You connect Blender to Claude via a local or remote MCP server and then send prompts to create or modify your 3D scene. Start the Blender MCP server, then configure Claude or your MCP client to point at that server. Once connected, you can query the current scene, create objects, apply materials, run Python code inside Blender, and download assets from supported providers. You’ll see controls in the Blender UI that let you initiate tasks from Claude and observe the results in real time.

How to install

Prerequisites you need before installing BlenderMCP:

Blender 3.0 or newer
Python 3.10 or newer
uvx package manager

If you are on Mac, install uv with Homebrew:

brew install uv

If you are on Windows, install uv with PowerShell and update your PATH:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 
`

After installing uv, verify that the Blender MCP server can be reached at the configured host/port (see environment variables below). Then install the Blender Addon.

# Step: install Blender addon
# 1) Open Blender
# 2) Edit > Preferences > Add-ons
# 3) Install… and select addon.py
# 4) Enable the addon labeled "Blender MCP"

Additional setup and configuration

Configure environment variables to point the MCP client at Blender:

export BLENDER_HOST='localhost'
export BLENDER_PORT=9876

Available tools

mesh_stats

Get detailed topology metrics including verts, edges, faces, tri/quad/ngon counts, surface area, and volume.

detect_topology_issues

Identify non-manifold edges, loose geometry, inverted normals, and duplicates.

voxel_remesh

Rebuild meshes using uniform voxel-based topology.

quadriflow_remesh

Generate quad-dominant meshes suitable for animation and subdivision.

decimate

Reduce polygon count while preserving shape for LODs.

shrinkwrap_reproject

Project low-poly meshes onto high-poly surfaces for accurate fitting.

set_view_projection

Toggle between orthographic and perspective projections.

align_view_to_axis

Snap the viewport view to a primary axis (Front/Back/Left/Right/Top/Bottom).

frame_selected

Frame the currently selected objects in the viewport.

mark_seams_by_angle

Auto-mark UV seams based on edge angles to improve unwrapping.

mark_sharp_by_angle

Mark sharp edges for correct shading in renders.

retopo_pipeline_prompt

Guided, step-by-step retopology workflow prompts.