MCP Directory
Back to Blog
blender-mcpmcp-serverblender-aiclaude-integration3d-modeling

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

August 11, 2026
3 min read

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

blender-mcp connects Blender to Claude AI through the Model Context Protocol (MCP), enabling developers to drive 3D modeling, scene creation, and object manipulation using natural language prompts. This integration facilitates direct AI control over Blender, supporting assets from Poly Haven and 3D model generation via Hyper3D Rodin.

Wiring Blender to Claude with MCP

The core of blender-mcp is its two-way, socket-based communication between Claude AI and Blender. This setup allows Claude to send commands to Blender and retrieve detailed scene information. The project consists of two main components:

  1. Blender Addon (addon.py): This Python script creates a socket server directly within Blender, listening for and executing commands received over the MCP connection.
  2. MCP Server (src/blender_mcp/server.py): This component implements the Model Context Protocol, acting as the bridge between Claude AI and the Blender addon.

To integrate blender-mcp, you'll configure your Claude environment to point to this MCP server. For instance, with Claude for Desktop, you'd modify claude_desktop_config.json. Similarly, Cursor users can configure their MCP settings to run the blender-mcp server.

Capabilities and Tools

Once connected, Claude gains a range of capabilities within Blender:

  • Object Manipulation: Create, modify, and delete 3D objects.
  • Material Control: Apply and modify materials and colors on objects.
  • Scene Inspection: Retrieve detailed information about the current Blender scene, including objects, their properties, and materials.
  • Code Execution: Run arbitrary Python code directly within Blender from Claude, enabling advanced customization and automation.
  • Asset Integration: Access and integrate assets from Poly Haven through their API.
  • AI-Generated Models: Prompt 3D models using Hyper3D Rodin for rapid prototyping and content generation.

These features are exposed as tools that Claude can invoke, allowing for a conversational approach to 3D design and scene assembly.

Installation and Setup

Getting blender-mcp running requires a few prerequisites and steps:

Prerequisites

  • Blender 3.0+
  • Python 3.10+
  • uv package manager (installable via brew install uv on Mac or PowerShell script on Windows)

Installing the Blender Addon

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

After the addon is installed and enabled, you can start the connection within Blender and then configure your Claude client (e.g., Claude for Desktop or Cursor) to interact with the blender-mcp server.

References

Back to all posts