Blender AI MCP Server
Provides tools for interacting with an active Blender 3D session, enabling scene inspection, object creation and transformation, Python automation, material and lighting setup, rendering, and model import/export.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Blender AI MCP Server & Live Bridge
An AI Model Context Protocol (MCP) server and bidirectional live bridge for Blender 3D. Connect AI assistants (such as Google Antigravity, Claude Desktop, Cursor, or OpenCode) directly to an active Blender session for real-time 3D scene inspection, geometry creation, Python script execution, and rendering.
Architecture Overview
+-------------------------------------------------------------+
| AI Agent / Client (Claude, Antigravity, Cursor) |
+-------------------------------------------------------------+
|
MCP Protocol (JSON-RPC stdio)
v
+-------------------------------------------------------------+
| Blender FastMCP Server (mcp_server.py) |
| Exposes standard MCP tools |
+-------------------------------------------------------------+
|
HTTP REST API (Port 9876)
v
+-------------------------------------------------------------+
| Blender Live Bridge (blender_bridge.py / blender_addon.py) |
| Main-Thread Execution Queue (bpy.app.timers) |
+-------------------------------------------------------------+
|
v
+-------------------------------------------------------------+
| Blender 3D Engine (bpy / bmesh / cycles / eevee) |
+-------------------------------------------------------------+Related MCP server: Blender MCP Bridge
Features
Thread-Safe Live Bridge: Executes all
bpyandbmeshcommands exclusively on Blender's main thread viabpy.app.timersto eliminate UI locks and crashes.Full Scene Inspection: Retrieve detailed object hierarchies, types, locations, bounding boxes, mesh polygon counts, and active camera settings.
Arbitrary Python Automation: Execute complex Blender Python scripts dynamically, with captured stdout, stderr, and returned dictionary results.
Parametric 3D Modeling: Create primitive meshes (cubes, cylinders, UV spheres, icospheres, cones, planes), apply translations, rotations, scaling, and configure modifiers.
Lighting & Camera Setup: Create and position cameras aimed at 3D targets, configure focal lengths, and set up scene illumination.
PBR Material Creation: Generate and configure Principled BSDF materials with base color, metallic, roughness, and transmission.
Viewport Rendering: Capture high-resolution viewport or Cycles/Eevee render frames and return image file paths directly to the AI model.
Two Integration Modes: Run as a simple script inside Blender's Text Editor or install as a permanent Blender Add-on with a dedicated Sidebar (N-panel) UI.
Installation & Quickstart
1. Install Package
git clone https://github.com/Ziad-Amr1/blender-ai-mcp.git
cd blender-ai-mcp
pip install -e .2. Start the Live Bridge inside Blender
Option A: Quick Script (No installation needed)
Open Blender.
Go to the Scripting workspace.
Open
blender_bridge.pyand click Run Script (Alt+P).The bridge starts listening on
http://127.0.0.1:9876.
Option B: Install as Blender Add-on
In Blender, navigate to Edit > Preferences > Add-ons > Install...
Select
blender_addon.py.Enable the checkbox for 3D View: Blender AI Bridge.
In the 3D Viewport, press N to open the sidebar, select the AI Bridge tab, and click Start Bridge Server.
MCP Client Configuration
Add the server to your MCP client configuration file:
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"blender": {
"command": "blender-mcp",
"env": {
"BLENDER_BRIDGE_URL": "http://127.0.0.1:9876"
}
}
}
}Antigravity (agy / settings.json)
{
"mcp": {
"servers": {
"blender": {
"command": "blender-mcp"
}
}
}
}Exposed MCP Tools
Tool Name | Description |
| Check if Blender Live Bridge is active and view scene stats. |
| Retrieve list of all scene objects, bounding boxes, and active camera. |
| Run arbitrary |
| Query objects matching specific names or types ( |
| Select, deselect, or set active object by name. |
| Spawn parametric primitive geometry at specified coordinates. |
| Move, rotate, or scale objects in world or relative coordinates. |
| Add and apply modifiers (Subsurf, Bevel, Boolean, Mirror, Solidify). |
| Position cameras aimed at targets and configure lighting. |
| Create PBR Principled BSDF materials with custom surface parameters. |
| Safely remove scene objects and purge orphan mesh datablocks. |
| Trigger viewport render or full F12 render and save image. |
| Import standard 3D formats (.stl, .obj, .fbx, .gltf, .ply). |
| Export scene or selected objects to STL, OBJ, FBX, or GLTF. |
License
Open source under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Blender-as-a-service for agents: search 3D assets, run Blender Python, or brief the studio agent.
Cloud Blender for AI agents: build, inspect, render and animate 3D scenes over remote MCP. Keep editable .blend projects and export GLB or STL. Make your first 3D asset free—30 compute minutes per UTC month, no credit card. First 100 eligible Free account owners to use all 30 minutes in one UTC month by December 31, 2026 UTC receive one calendar month of beta free: 4 compute hours per UTC month, 2 concurrent workers per deployment, 2 deployments, 2048×2048 renders at up to 256 samples, and 10 GiB storage. Existing usage counts toward the 4-hour allowance. Limited to 100 rewards; expires January 1, 2027 00:00 UTC. Free resumes afterward without an automatic charge. Examples, eligibility and terms: https://sceneplane.online/launch?utm_source=glama&utm_medium=directory&utm_campaign=first100
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceConnects AI assistants to Blender 3D for natural language 3D modeling, scene inspection, material creation, and rendering.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to drive a live Blender session over MCP by creating and transforming primitives, building and assigning materials, inspecting scenes and objects, capturing viewport screenshots, and executing arbitrary bpy Python. Commands are relayed over a local TCP bridge to a Blender add-on and executed on Blender's main thread, supporting multiple simultaneous AI clients.MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to control a live Blender session, manage scenes, objects, materials, and renders, download PolyHaven assets, and switch between multiple LLM backends at runtime.-
- AlicenseNot gradedqualityCmaintenanceEnables AI clients to interact with a local Blender desktop application through a TCP bridge for scene inspection, rendering, asset export, visual comparison, and controlled mesh operations.MIT