Quickstart
Get from zero to your first AI-driven 3D scene in under 5 minutes.
Installation
Detailed setup for the MCP server, Blender addon, and supported clients.
Integrations
Connect Poly Haven, Sketchfab, Poly Pizza, Hyper3D Rodin, and Hunyuan3D.
Use Cases
See how studios and creators use prompt-driven 3D across industries.
How it works
Blender MCP has two parts: a Blender addon that runs a socket server inside Blender, and a Python MCP server (blender-mcp on PyPI). The MCP server receives your prompts from Claude or any compatible client, translates them into Blender commands, and streams the results back so you can iterate in seconds.
1
Install uv
Install the uv package manager. Blender MCP uses it to run the MCP server and install the addon.
2
Add the MCP server to your client
Register
uvx blender-mcp with Claude Desktop, Claude Code, or another MCP client.3
Install the Blender addon
Run
uvx blender-mcp install-addon, then enable it in Blender under Edit → Preferences → Add-ons → Interface: Blender MCP.4
Start the server
In Blender, press N in the 3D viewport, open the BlenderMCP tab, and click Start MCP Server.
Integrations
Connect external asset libraries and AI 3D generators to expand what your prompts can produce.Poly Haven
Free HDRIs, textures, and 3D models.
Sketchfab
Realistic models. API key required.
Poly Pizza
Low-poly models. ~10,600 free assets.
Hyper3D Rodin
AI 3D generation from text or images.
Hunyuan3D
AI 3D generation by Tencent.
Requirements
- Blender 3.0 or newer
- Python 3.10 or newer
- uv package manager
Blender MCP communicates over JSON on a TCP socket at
localhost:9876. You can change the host and port with the BLENDER_HOST and BLENDER_PORT environment variables.