skills.rest
MLT-OSS
MLT-OSSOFFICIAL
Explore all skills by this author →
WebsiteGitHub

blender-mcp

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

14|5|Updated Apr 9, 2026
Search Tags:#rendering#mcp#animation#socket#blender#bpy#3d modeling
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill blender-mcp-mlt-oss
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill blender-mcp-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automating Blender normally requires writing standalone Python scripts or manual GUI work. This Skill lets you drive a running Blender instance directly from Hermes, executing arbitrary bpy code, inspecting scenes, and capturing viewport screenshots through a simple socket protocol. ## Core Features & Use Cases - Remote bpy Execution: Send arbitrary Blender Python code over TCP port 9876 to create meshes, materials, keyframe animations, and renders. - Scene Inspection: Query scene contents and individual object details, plus capture viewport screenshots for visual verification. - Use Case: Ask the agent to build a 3D scene with a sphere, cube, and cylinder, assign colored Principled BSDF materials, animate an object rising over 60 frames, and render the result to a PNG file. ## Quick Start Connect to my running Blender instance and create a red metallic sphere with a keyframed animation, then render it to /tmp/render.png.

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 remotely?▼

Install the blender-mcp addon in Blender, start its socket server from the N-panel BlenderMCP tab, 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. For materials, create a bpy.data.materials entry, enable nodes, and set Base Color, Roughness, and Metallic on the Principled BSDF node.

Does blender-mcp work with headless Blender?▼

No, blender-mcp requires a desktop Blender 4.3 or later instance because the addon runs inside Blender's GUI. Headless or background-mode Blender is not supported by this setup.

Why does the Blender socket connection fail?▼

The addon server must be started manually each session via the N-panel BlenderMCP tab. Verify the port is open with nc -z localhost 9876 before sending commands, and confirm the addon is enabled in Blender preferences.

What are the limitations of executing bpy code over a socket?▼

Large or complex scene operations can hit socket timeouts, so break work into multiple smaller execute_code calls. Render output paths must be absolute, and operations like shade_smooth require the object to be selected in object mode.

Related Skills

Explore More Design & Creative Skills→
zerwizzerwiz

blender-mcp

Control a running Blender instance via socket bridge to automate scene creation and editing.

Community
Advanced
Logos-LiberLogos-Liber
17

omniverse

Integrate with NVIDIA Omniverse for real-time 3D scene composition and collaboration.

Official
Advanced
linegellinegel
5

threejs-object-sculptor

Convert images into procedural Three.js models with geometry, materials, and lighting.

Community
Advanced
flaz78flaz78
9

blender_skill

Automate Blender scene creation and rendering via JSON actions.

Community
Advanced