Skip to content

BlenderForge

Control Blender with AI through natural language conversation

PyPI Downloads Python Blender License MCP

Overview

BlenderForge connects AI assistants to Blender using the Model Context Protocol (MCP). Instead of learning complex menus and Python scripts, just describe what you want in plain English.

You: Create a cozy coffee shop scene with wooden tables and warm lighting

AI: I'll create that for you...
    ✓ Setting up warm HDRI lighting from PolyHaven
    ✓ Adding wooden tables with realistic textures
    ✓ Placing coffee cups and decorations
    ✓ Adjusting camera for a cozy atmosphere

Quick Start

1. Install BlenderForge

pip install blenderforge

uv pip install blenderforge

pipx install blenderforge

2. Install the Blender Addon

  1. Click here to download addon.py
  2. In Blender: Edit → Preferences → Add-ons → Install...
  3. Select addon.py and enable the checkbox
  4. Click Save Preferences

3. Configure Your AI

{
  "mcpServers": {
    "blenderforge": {
      "command": "blenderforge"
    }
  }
}

4. Connect

  1. In Blender: Press N → BlenderForge tab → "Connect to MCP server"
  2. Restart your AI assistant
  3. Start creating!

Full Installation Guide

Features

Core Tools

Tool Description
Scene Query Get information about objects, materials, settings
Object Creation Add and modify 3D objects
Code Execution Run any Blender Python code
Screenshots Capture viewport images
Asset Download Get free textures, HDRIs, 3D models
3D Generation Generate models from text or images

AI-Powered Features

Feature Description
Material Generator Create PBR materials from text descriptions
NLP Modeling Create objects with plain English
Scene Analyzer Professional critique with scores
Auto-Rig Automatically rig characters
Auto-Lighting Studio, cinematic, dramatic presets

Supported AI Assistants

AI Assistant Developer Status
Claude Desktop/Code Anthropic ✅
ChatGPT Desktop OpenAI ✅
VS Code + Copilot Microsoft ✅
Cursor IDE Cursor ✅
Windsurf Codeium ✅
Zed Editor Zed ✅
Continue.dev Continue ✅

Works with any MCP-compatible client (481+ and growing).

Architecture

flowchart LR
    A[AI Assistant] -->|MCP Protocol| B[BlenderForge Server]
    B -->|Socket| C[Blender Addon]
    C -->|Python API| D[Blender]

    style A fill:#000,stroke:#333,color:#fff
    style B fill:#333,stroke:#000,color:#fff
    style C fill:#666,stroke:#333,color:#fff
    style D fill:#999,stroke:#666,color:#000

System Requirements

Component Requirement
Python 3.10+
Blender 3.0+ (4.x recommended)
OS Windows, macOS, Linux

Documentation

Guide Description
Getting Started Installation and setup
AI Clients Configuration for each platform
Tools Reference Complete tool documentation
AI Features Material generator, NLP, analysis
Troubleshooting Common issues and solutions

License: MIT | Author: Mithun Gowda B