Create 3D Models with Claude AI in Blender Using MCP

Imagine being able to type “Build me a campfire in a forest with animals around it”—and seeing that scene come to life inside Blender. Welcome to BlenderMCP — the Blender Model Context Protocol integration that connects Claude AI directly with Blender through the Model Context Protocol (MCP).

Whether you’re a beginner experimenting with AI or a 3D artist looking to accelerate your workflow, BlenderMCP offers a magical, text-to-3D modeling experience. Let’s dive into how it works, what you can do with it, and how to get started!

What Is BlenderMCP?

BlenderMCP enables two-way communication between Blender and Claude AI using a socket-based server. Through simple text prompts, Claude can generate, modify, and manipulate 3D scenes right inside Blender.

Think of it as ChatGPT for Blender, but with full 3D modeling capabilities.

🔧 Key Features

• Object Manipulation: Create, modify, and delete Blender objects via prompt
• Material Control: Apply textures and adjust material properties
• Scene Inspection: Get detailed metadata about objects in the scene
• Python Execution: Claude can write and execute custom Blender Python scripts
• Poly Haven Integration: Import HDRIs, textures, and models via API
• Hyper3D Integration: Generate detailed 3D models from text with Hyper3D Rodin

Installation Guide

Prerequisites

• Blender 3.0 or newer
• Python 3.10+
• uv package manager

Install uv:

Mac:

brew install uv

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
set Path=C:\Users\yourname\.local\bin;%Path%

Setup Instructions

1. Claude for Desktop Integration

In Claude, go to:

Settings > Developer > Edit Config

Paste this into your claude_desktop_config.json:

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

2. Cursor Integration (Optional)

Mac users can paste the same configuration under Settings > MCP, or create a .cursor/mcp.json.

Windows users should use this:

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

Install the Blender Add-on

1. Download the addon.py from the repo
2. Open Blender > Edit > Preferences > Add-ons
3. Click Install and select addon.py
4. Enable “Interface: Blender MCP” in the Add-ons list

How to Use BlenderMCP

1. Launch the MCP server using uvx blender-mcp
2. In Blender, press N to open the sidebar
3. Go to the BlenderMCP tab
4. (Optional) Enable Poly Haven for assets
5. Click Connect to Claude

In Claude, a hammer icon will appear, unlocking MCP tools. Try prompts like:

• "Create a low-poly forest with animals and a campfire"
• "Generate a garden gnome model using Hyper3D"
• "Make the lighting like a studio setup"
• "Turn the cube metallic red"
• "Generate a beach scene using HDRI and vegetation from Poly Haven"

Behind the Scenes

BlenderMCP uses a JSON-based TCP socket protocol. Claude sends commands like:

{
  "type": "create_object",
  "params": {
    "shape": "cube",
    "location": [0, 0, 0]
  }
}

And receives:

{
  "status": "success",
  "result": {
    "object_id": "Cube"
  }
}

It’s fast, flexible, and incredibly powerful.

Demo Prompt

“Create a low poly forest scene with animals and a glowing campfire in the middle.”

In seconds, Claude generates Python code, spawns terrain, trees, animals, and builds a procedural campfire—all inside Blender.

Rendered in Cycles, it even adds light emission and natural textures. The result? A magical 3D scene created entirely from your imagination.

What’s New in v1.1.0

• Poly Haven API support for HDRIs, textures, and models
• Hyper3D integration for model generation via text
• Simplified update process: Replace addon.py and restart the Claude MCP server