AI-Powered 3D Modeling with Blender MCP

Blender MCP is a plugin that allows you to control 3D modeling in Blender using natural language through Claude, Cursor, Windsurf, or VSCode.

Get StartedDownload Plugin
Trusted by 3D creators worldwide
Blender MCP Core Demo

How Claude Works with Blender MCP

From natural language to 3D models — in just four simple steps.

Blender MCP Works – Step-by-Step

  1. Write a Simple Text Prompt
    Example: "I want a green tree with round leaves."
  2. Claude AI Understands Your Request
    Claude AI processes your sentence and converts it into modeling instructions.
  3. MCP Sends It to Blender
    The MCP plugin acts as a translator, sending AI-generated commands to Blender.
  4. Blender Creates the 3D Model
    In just a few seconds, your custom 3D model appears on screen, fully generated from your description.
How Blender MCP Works Visual Flow

Set Up Blender MCP Quickly on Claude

Set up Blender MCP in just a few steps. No technical skills required.

1

Install Blender MCP in Blender

Download Blender MCP from GitHub and install it in Blender.

Download Plugin
2

Configure MCP Server

Set up the MCP server to connect Blender with Claude AI.

View Full Installation Guide
3

Start Creating with AI

Use plain language to create and edit 3D models in Blender.

See Examples

Getting Started with Blender MCP on Claude

Set up and use Blender MCP in minutes with this step-by-step guide.

Watch this 2-minute video to see Blender MCP in action.

🖥️ System Requirements

  • Blender 3.0 or higher
  • Python 3.10+ environment
  • Claude API Key (e.g., claude-xxx)
  • uv package manager
Install uv on Windows:
pip install uv
Install uv on Mac:
brew install uv
⚠️Please install UV before proceeding.

💻 Claude for Desktop Integration

  1. Go to Claude > Settings > Developer > Edit Config and open claude_desktop_config.json.
  2. Add the following configuration:
Config Example:
{ "mcpServers": { "blender": { "command": "uvx", "args": [ "blender-mcp" ] } } }

🔗 MCP Integration in Different Environments

Cursor Integration

Cursor Integration Demo
Cursor Integration Demo

Go to Cursor Settings > MCP and paste the following command:

uvx blender-mcp

Windsurf Integration

Windsurf Integration Demo
Windsurf Integration Demo

Go to Windsurf Settings > MCP and paste the following command:

uvx blender-mcp

VSCode Integration (using Roo Cline)

  1. Install the Roo Cline extension in VSCode
    VSCode Step 1
    VSCode Step 1
  2. Set your API key
    VSCode Step 2
    VSCode Step 2
  3. Configure the MCP server with the command uvx blender-mcp
    VSCode Step 3
    VSCode Step 3
uvx blender-mcp
⚠️Important: Run only one MCP server instance at a time. Do not open it in multiple environments such as Cursor, Windsurf, VSCode, or Claude Desktop simultaneously.

🧩 Installing the Blender Plugin

  1. Download the latest version of Blender MCP.
  2. Open Blender.
  3. Go to Edit > Preferences > Add-ons.
  4. Click Install... and select the addon.py file.
  5. Enable the plugin by checking the box next to Interface: Blender MCP.
Blender plugin installation screenshot: Addon Preferences
Blender Preferences > Add-ons > Install
Blender MCP server start screenshot
Start MCP server in Blender sidebar (press N if not visible)
⚠️
Important: Upgrade Instructions
If Blender MCP was previously installed, uninstall it before installing the new version.
  1. Open Blender. Go to Edit > Preferences > Add-ons.
  2. Locate Interface: Blender MCP and uncheck the box to disable it.
  3. Click the arrow next to it, then click Remove.
  4. Restart Blender.
  5. Install the updated version.

🚀 Usage Instructions

Starting the Connection

  1. In Blender, open the 3D View sidebar (press N if it is not visible).
  2. Select the BlenderMCP tab.
  3. (Optional) Enable the Poly Haven checkbox to use Poly Haven assets.
  4. Click Start MCP Server.
  5. Confirm that the MCP server is running in your terminal.

Using with Claude

After the config file is set up in Claude and the plugin is active in Blender, a hammer icon will appear.
This icon gives you access to Blender MCP tools.

Example Commands

  • Create a low poly scene in a dungeon, with a dragon guarding a pot of gold
  • Create a beach vibe using HDRIs, textures, and models like rocks and vegetation from Poly Haven
  • Get information about the current scene, and make a threejs sketch from it
  • Make this car red and metallic
  • Create a sphere and place it above the cube
  • Make the lighting like a studio
  • Point the camera at the scene, and make it isometric
  • Create a sci-fi corridor with glowing walls and a metal floor
  • Build a forest scene with scattered trees, rocks, and a small river
  • Add a glass sphere on top of a wooden table
  • Make this object matte black with rough surface finish
  • Use Poly Haven textures to create a cozy indoor living room
  • Set up HDRI lighting for a sunset look
  • Rotate the camera 45 degrees and point it at the center of the scene
  • Get a list of all objects in the scene and their positions
  • Export the scene as a glTF file
  • Add soft shadows and reduce overall brightness by 20%