What is Blender MCP?
Blender MCP (Model Context Protocol) is a seamless integration layer that empowers Large Language Models (LLMs) to take control of Blender using simple JSON instructions. It turns AI into a real-time 3D collaborator—through a fast and open TCP-based connection.
Instant AI-to-3D Pipeline
Generate, modify, and animate Blender scenes in real time by connecting any LLM to the MCP server. No plugins, no manual clicks—just pure AI-driven creativity.
Lightweight JSON Protocol
Communicate using clean and structured JSON commands over TCP. Designed for reliability, simplicity, and extensibility—perfect for research and rapid prototyping.
Plug & Play with Any LLM
Easily hook up models like Claude, ChatGPT, or open-source LLMs to your Blender environment. Claude Desktop already supports direct MCP server input—just add your server and start building.
Scene Manipulation
Complete control over 3D scenes, objects, materials, and animations with precise command execution.
Total Scene Control
Create meshes, move objects, apply materials, trigger animations—Blender MCP gives the AI full access to manipulate your 3D world.
Why We Built Blender MCP
Blender MCP was created to establish a standardized, universal interface between Large Language Models and 3D software like Blender—making AI-powered 3D creation accessible, fast, and intuitive.
Whether you're a Blender pro looking to speed up complex workflows or a curious beginner(like us when we started!)trying to bring your ideas to life without wrestling with UI or scripting—Blender MCP bridges that gap.
We believe the future of 3D content lies innatural language + real-time control. This project makes that future usable today.
Project Details
Code Architecture
TCP Server
Handles incoming connections and JSON command parsing
Command Processor
Translates JSON commands to Blender Python API calls
Scene Controller
Manages 3D scene state and object manipulation
Example JSON Payload
{
"command": "create_object",
"type": "cube",
"name": "my_cube",
"location": [0, 0, 0],
"scale": [1, 1, 1],
"material": {
"name": "blue_material",
"color": [0, 0, 1, 1]
}
}How to Setup
Clone the Repository
git clone https://github.com/pranav-deshmukh/blender-mcpcd blender-mcp-demopnpm i && node index.jsClaude Desktop Integration
Go to Claude → Settings → Developer → Edit Config → claude_desktop_config.json and add:
{
"mcpServers": {
"DemoServer": {
"command": "node",
"args": ["path to index.js file of cloned repo"]
}
}
}Install Blender Addon
Open Blender → Edit → Preferences → Add-ons → Install from Disk
Navigate to cloned repo → addon folder → Select simple_mcp_addon.py → Click Install from Disk
Start MCP Server in Blender
In Blender, go to the right sidebar → Click on MCP → Click Start MCP Server
Meet the Creator
Passionate about bridging the gap between AI and creative tools
Pranav Deshmukh
Software Engineer
Building the future where artificial intelligence seamlessly collaborates with human creativity. Specializing in real-time 3D systems, protocol design, and making complex technology accessible to creators worldwide.