blender-mcpmcp-serverblender-aiclaude-integration3d-modeling

blender-mcp: AI-Assisted 3D Modeling with Claude via MCP Server

November 3, 2026
3 min read

blender-mcp: AI-Assisted 3D Modeling with Claude

blender-mcp connects Blender to Claude AI via the Model Context Protocol, allowing developers to drive 3D modeling, scene creation, and object manipulation directly from AI prompts. This Python-based MCP Server acts as a bridge, translating Claude's instructions into Blender actions.

Wiring Claude to Blender

The core of blender-mcp is its socket-based, two-way communication between Claude AI and Blender. This integration is facilitated by two main components: a Blender Addon (addon.py) that creates a socket server within Blender to receive commands, and the MCP Server (src/blender_mcp/server.py) which implements the Model Context Protocol and connects to the Blender addon.

To get started, you'll need Blender 3.0+, Python 3.10+, and the uv package manager. Once the addon.py is installed in Blender's Add-ons preferences and enabled, the MCP Server can be configured for use with Claude. This involves including the Blender MCP server in your claude_desktop_config.json for Claude for Desktop integration, or configuring Cursor's MCP settings to run the server.

Direct AI Control Over Your 3D Scene

With blender-mcp, Claude gains a comprehensive set of capabilities for interacting with Blender:

  • Object Manipulation: Create, modify, and delete 3D objects.
  • Material Control: Apply and modify materials and colors.
  • Scene Inspection: Retrieve detailed information about the current Blender scene.
  • Code Execution: Run arbitrary Python code within Blender directly from Claude.
  • Asset Integration: Access Poly Haven assets through their API and generate 3D models using Hyper3D Rodin.

These capabilities enable AI-driven workflows for tasks ranging from procedural scene generation to rapid prototyping of 3D assets based on natural language descriptions.

Installation and Setup

Prerequisites

Before installing, ensure you have:

  • Blender 3.0 or newer
  • Python 3.10 or newer
  • uv package manager:
    • Mac: brew install uv
    • Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex" followed by set Path=C:\Users\nntra\.local\bin;%Path%
    • Otherwise, follow instructions on the uv website

Installing the Blender Addon

  1. Download the addon.py file from the blender-mcp GitHub repository.
  2. Open Blender.
  3. Navigate to Edit > Preferences > Add-ons.
  4. Click "Install..." and select the downloaded addon.py file.
  5. Enable the addon by checking the box next to "Interface: Blender MCP".

Once the addon is enabled in Blender, you can connect to Claude and begin interacting with Blender using the Blender MCP tools.

References