blender-mcp
Author: ahujasid
Description: Blender Model Context Protocol (MCP) server that lets Claude AI (and other MCP-aware IDEs such as Cursor, VS Code, and Claude Desktop) drive a live Blender session for prompt-assisted 3D modelling, scene inspection, and code execution inside Blender.
Stars: 16.9k
Forks: 1.6k
License: MIT License
Category: Open Source
Overview
Installation
Prerequisites
- Python 3.10 or newer
- Blender 3.0 or newer
- uv package manager
Step 1: Install the uv package manager
Mac:
brew install uvWindows:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"Then add uv to the user path (Windows, may need to restart Claude Desktop after):
$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")Step 2: Install the Blender Addon
1. Download the addon.py file from the GitHub repository (https://github.com/ahujasid/blender-mcp)
2. Open Blender
3. Go to Edit > Preferences > Add-ons
4. Click "Install..." and select the addon.py file
5. Enable the addon by checking the box next to "Interface: Blender MCP"
Step 3: Configure your MCP client
Claude Desktop:
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json and add:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}Claude Code:
claude mcp add blender uvx blender-mcpCursor (Mac):
Go to Settings > MCP and paste:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}Cursor (Windows):
{
"mcpServers": {
"blender": {
"command": "cmd",
"args": ["/c", "uvx", "blender-mcp"]
}
}
}VS Code:
Install directly through the MCP extension. The server runs as a stdio process.
Step 4: Connect
1. In Blender, go to the 3D View sidebar (press N if not visible)
2. Find the "BlenderMCP" tab
3. Turn on the Poly Haven checkbox for asset API access (optional)
4. Click "Connect to Claude"
5. Confirm the hammer icon appears in your AI assistant, indicating tools are available
Environment Variables (Optional)
BLENDER_HOST: Host address for Blender socket server (default: localhost)
BLENDER_PORT: Port number for Blender socket server (default: 9876)
Disabling Telemetry (Optional)
Add the environment variable to your MCP config:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"],
"env": {
"DISABLE_TELEMETRY": "true"
}
}
}
}01
execute_blender_code
Run arbitrary Python code directly inside the connected Blender instance
License: MIT License
Updated 2/6/2026