skills.rest
xu1713
xu1713COMMUNITY
Explore all skills by this author →
GitHub

blender-mcp

Control Blender over a TCP socket to create 3D objects, materials, and animations via bpy.

Updated Jun 5, 2026
Search Tags:#rendering#mcp#animation#socket#blender#bpy#3d modeling
One-click install
npx skills add https://github.com/xu1713/openhorse --skill blender-mcp-xu1713
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/xu1713/openhorse/tree/main/openhorse/openhorse/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/xu1713/openhorse --skill blender-mcp-xu1713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually scripting Blender requires switching between the Blender UI and external editors, making iterative 3D scene creation slow. This Skill lets an AI assistant send commands directly to a running Blender instance over a socket, so scenes, materials, animations, and renders are produced from natural language requests. ## Core Features & Use Cases - Remote bpy Execution: Run arbitrary Blender Python code through the blender-mcp addon's socket server on port 9876. - Scene Inspection: Query scene contents, object details, and capture viewport screenshots to verify results. - Use Case: Ask the assistant to build a product mockup scene with a sphere, cube, and cylinder, assign metallic materials, keyframe a simple animation, and render the result to a PNG file. ## Quick Start Ask the assistant to connect to Blender and create a red metallic sphere in the current scene.

Frequently Asked Questions about blender-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Blender from Python or an AI assistant?▼

Install the blender-mcp addon in Blender, start its socket server from the N-panel sidebar, then send JSON commands over TCP port 9876. The execute_code command runs arbitrary bpy Python code inside the running Blender instance.

How to create 3D objects and materials in Blender with bpy?▼

Use bpy.ops.mesh primitives like primitive_uv_sphere_add or primitive_cube_add to create objects, then build materials with bpy.data.materials.new and configure the Principled BSDF node for color, roughness, and metallic values.

Does blender-mcp work with headless Blender?▼

No, a desktop Blender instance is required and headless mode is not supported. Blender 4.3 or later must be running with the addon enabled and its socket server started from the BlenderMCP sidebar tab.

Why does the Blender socket connection fail or time out?▼

The addon server must be started manually inside Blender each session via the N-panel BlenderMCP tab. Verify the port is open with nc -z localhost 9876, and break complex scenes into smaller execute_code calls to avoid timeouts.

What are the limitations of controlling Blender over a socket?▼

Commands are plain JSON over TCP with no length prefix, so large payloads risk timeouts. Render paths must be absolute, and operations like shade_smooth require the object to be selected and in object mode first.

Related Skills

Explore More Design & Creative Skills→
azaanalirazaazaanaliraza

blender-mcp

Controls Blender over a TCP socket to create 3D objects, materials, and animations via bpy code.

Community
Intermediate
getfnddgetfndd

storyboard

Generate validated scene JSON files from creative briefs for video production.

Community
Advanced
ZeyuzhaoZeyuzhao

visual-verification

Capture and upload viewport or full-page screenshots to verify UI changes.

Community
Basic
HKUDSHKUDS
46.8k

cli-anything-blender

Automate Blender 3D scene creation, editing, and rendering via command-line.

Official
Intermediate