Blender MCP

Turning AI into your creative Blender co-pilot.

Realtime 3D Control via Model Context Protocol

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]
  }
}

Live Demo

Real-time LLM commanding Blender

Blender MCP Demo

Real-time 3D control

Click to pause • Scroll to continue
Scroll to expand
Continue scrolling

How to Setup

1

Clone the Repository

git clone https://github.com/pranav-deshmukh/blender-mcp
cd blender-mcp-demo
pnpm i && node index.js
2

Claude 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"]
    }
  }
}
3

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

4

Start MCP Server in Blender

In Blender, go to the right sidebar → Click on MCP → Click Start MCP Server

✓

Ready to Use!

Your Blender MCP setup is complete. You can now control Blender through Claude Desktop using natural language commands.

Meet the Creator

Passionate about bridging the gap between AI and creative tools

PD

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.

Web
Years in Full Stack Web Development
AI
LLM, agents, mcp Focus
∞
Creative Possibilities