This project provides a Python-based integration between Blender and Claude AI, enabling users to control and interact with Blender scenes using natural language prompts. It targets 3D artists, designers, and developers looking to streamline their workflow by leveraging AI for scene creation, object manipulation, and material application. The primary benefit is an intuitive, prompt-driven approach to complex 3D tasks.

How It Works

The system comprises a Blender Addon (addon.py) acting as a socket server and a Python MCP Server (src/blender_mcp/server.py). The addon listens for commands sent over TCP sockets from the MCP server, which interfaces with Claude AI. This two-way communication allows Claude to execute Python code within Blender, inspect scene details, and manipulate objects and materials, effectively translating natural language instructions into actionable Blender operations.

Quick Start & Requirements

• Installation: Install the addon.py file in Blender. Configure Claude Desktop or Cursor IDE with the provided JSON settings. Ensure uv package manager is installed.
• Prerequisites: Blender 3.0+, Python 3.10+, uv package manager.
• Setup: Follow setup videos for Claude and Cursor integration.
• Docs: Installation, Setup Instruction Video, Cursor Setup Video

Highlighted Details

• Integrates with Poly Haven API for asset fetching.
• Supports AI-generated 3D models via Hyper3D Rodin.
• Enables arbitrary Python code execution within Blender from Claude.
• Facilitates scene inspection, object manipulation, and material control.

Maintenance & Community

• Project supported by "CodeRabbit" and other top supporters.
• Community Discord server available for feedback and inspiration.
• Discord

Licensing & Compatibility

• The repository does not explicitly state a license.

Limitations & Caveats

The execute_blender_code tool allows arbitrary Python execution, posing potential security risks; users are advised to save work frequently. Complex operations may require breaking down into smaller steps. Hyper3D integration is subject to daily free trial limits.