skills.rest
afel6
afel6COMMUNITY
Explore all skills by this author →
GitHub

blender-mcp

Control Blender over a TCP socket to execute bpy commands.

Updated Mar 25, 2026
Search Tags:#rendering#animation#3d#socket#remote-control#blender#bpy
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill blender-mcp-afel6
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill blender-mcp-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable remote, programmatic control of a desktop Blender instance so users can create, modify, animate, and render 3D content without manual interaction in the Blender UI.

Core Features & Use Cases

  • Execute Arbitrary bpy Code: Send Python (bpy) code to a running Blender instance for complex modeling, material setup, animation keyframing, and rendering.
  • Scene Inspection & Automation: Retrieve scene and object information, capture viewport screenshots, and automate repetitive tasks across sessions.
  • Use Case: Integrate into an engineering or content pipeline to generate optimized meshes, apply procedural materials, produce keyframed animations, and export renders programmatically.

Quick Start

Start Blender with the blender-mcp addon enabled, start the addon server in the N-panel, and ask Hermes to execute a simple bpy command to add a UV sphere at the origin.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I execute remote bpy commands to control Blender programmatically?▼

Remote bpy commands are sent via JSON-over-TCP to a running Blender instance, enabling programmatic modeling, material setup, and animation keyframing without manual UI interaction.

Can I use a TCP socket to automate Blender rendering and scene inspection?▼

Yes, Blender rendering and scene inspection can be automated over a TCP socket. The connection retrieves object information, captures viewport screenshots, and executes file rendering tasks programmatically.

What Blender version and setup do I need for remote control via a TCP socket?▼

Remote control via TCP requires desktop Blender 4.3 or higher. You must enable the blender-mcp addon, start its server in the N-panel, and ensure local socket availability on localhost port 9876.

Does blender-mcp work with headless Blender instances or only desktop UI sessions?▼

blender-mcp applies to desktop Blender 4.3+ instances requiring a running addon and local socket availability. The metadata does not indicate support for headless rendering sessions without the UI.

What communication protocol does this Blender remote control approach use?▼

The Blender remote control approach uses JSON-over-TCP communication. It transmits bpy commands and scene management data locally on localhost port 9876 between the client and the Blender addon.

Why is my Blender remote control connection not working on localhost port 9876?▼

Blender remote control connections fail when the blender-mcp addon server is not started in the N-panel or local socket availability is blocked. Ensure the addon is actively running on port 9876 before sending commands.

Related Skills

Explore More Design & Creative Skills→
sheawinklersheawinkler
78

blender-mcp

Control a running Blender instance via a TCP socket connection.

Community
Advanced
MarbleSodasMarbleSodas

blender-mcp

Send remote commands to a live Blender instance for scene creation and modification.

Community
Intermediate
tusosostusosos

blender-scripting

Automate Blender tasks and procedural modeling with Python and bpy.

Community
Intermediate
heysuhasheysuhas
2

blender-mcp

Control a running Blender instance via TCP socket for automated 3D scene manipulation.

Community
Advanced