Blender MCP Server

Blender MCP Server connects Blender to Claude AI through the Model Context Protocol (MCP), enabling prompt-assisted 3D modeling, scene creation, and manipulation.

GitHub stars

Overview

The Blender MCP Server connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. It is listed as a third-party MCP server in the official Model Context Protocol repository.

The system consists of two main components:

  • Blender Addon (addon.py): A Blender addon that creates a socket server within Blender to receive and execute commands
  • MCP Server (src/blender_mcp/server.py): A Python server that implements the Model Context Protocol and connects to the Blender addon

Key Features

🔄

Two-Way Communication

Connect Claude AI to Blender through a socket-based server

🪐

Object Manipulation

Create, modify, and delete 3D objects in Blender

🎨

Material Control

Apply and modify materials and colors

👀

Scene Inspection

Get detailed information about the current Blender scene

💻

Code Execution

Run arbitrary Python code in Blender from Claude

🗂️

Asset Integration

Access Poly Haven assets and generate models with Hyper3D Rodin

Available Tools

Quick Reference

ToolPurposeCategory
execute_blender_codeRun arbitrary Python code in BlenderExecution
create_objectCreate 3D objects in BlenderManipulation
modify_materialApply or modify materials for objectsMaterial
inspect_sceneGet detailed scene and object informationInspection
download_poly_haven_assetDownload assets from Poly HavenAssets
generate_hyper3d_modelGenerate 3D models using Hyper3D RodinGeneration

Detailed Usage

execute_blender_code

Warning:

Use with caution in production environments as it allows running arbitrary code

Run arbitrary Python code in Blender from Claude.

use_mcp_tool({
  server_name: "blender",
  tool_name: "execute_blender_code",
  arguments: {
    code: "import bpy; bpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 0))"
  }
});
create_object

Create 3D objects (e.g., cube, sphere) in the Blender scene.

use_mcp_tool({
  server_name: "blender",
  tool_name: "create_object",
  arguments: {
    type: "cube",
    size: 2,
    location: [0, 0, 0]
  }
});
modify_material

Apply or modify materials and colors for Blender objects.

use_mcp_tool({
  server_name: "blender",
  tool_name: "modify_material",
  arguments: {
    object_name: "Cube",
    material_name: "RedMaterial",
    color: [1, 0, 0, 1]
  }
});
inspect_scene

Get detailed information about the current Blender scene and objects.

use_mcp_tool({
  server_name: "blender",
  tool_name: "inspect_scene",
  arguments: {}
});

Installation

Prerequisites

  • Blender 3.0 or newer
  • Python 3.10 or newer
  • uv package manager (install via brew install uv on macOS)

Claude Desktop Integration

Add the following configuration to claude_desktop_config.json:

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

Blender Addon Installation

  1. Download the addon.py file from the GitHub repo
  2. Open Blender > Edit > Preferences > Add-ons
  3. Install and enable the "Interface: Blender MCP" addon