Skip to main content
Blender MCP lets you control Blender with natural language prompts via Claude or any MCP-compatible AI client. This guide gets you from zero to your first AI-generated 3D scene. Watch the full walkthrough below, or follow the steps.
Prerequisites: Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager.
1

Install uv

Install the uv package manager for your platform. Do not install uv through pip; use the official installer.
Do not install uv with pip install uv. Use the official installer above to avoid compatibility issues.
2

Add the MCP server to your client

Register the Blender MCP server so your AI client can send prompts to Blender.Claude Desktop: Add this to your Claude Desktop MCP configuration:
Claude Code:
For Cursor, Windsurf, and other clients, see MCP Clients.
3

Install the Blender addon

Run the install command, then enable the addon inside Blender.
After installation, open Blender and enable the addon:
  1. Go to Edit → Preferences → Add-ons
  2. Search for Interface: Blender MCP
  3. Check the box to enable it
4

Connect and start the server

In Blender, press N in the 3D viewport to open the sidebar.
  1. Select the BlenderMCP tab
  2. Click Start MCP Server
The server listens on localhost:9876 by default. You can override this with the BLENDER_HOST and BLENDER_PORT environment variables.
Only run one instance of the MCP server at a time. Do not run it simultaneously in both Cursor and Claude Desktop, for example.

​
Your first prompt

Open your MCP client and try one of these prompts to see Blender MCP in action:
  • “Create a low poly dungeon scene with a dragon guarding a pot of gold”
  • “Create a beach scene using HDRIs, textures, and vegetation from Poly Haven”
  • “Create a sphere and place it above the cube”
The AI translates your request into Blender commands and builds the scene in real time.
The execute_blender_code tool runs arbitrary Python inside Blender. Save your work before using AI-generated code, especially in complex scenes.

​
Next steps

Installation

Advanced setup, environment variables, and credential management.

MCP Clients

Configure Cursor, Windsurf, and other MCP-compatible clients.

Integrations

Add asset libraries and AI 3D generators to expand your scenes.