blender-mcp

Control a live Blender instance over TCP to execute bpy code and query scene information.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/Monjyu1101/AiDiy2026 --skill blender-mcp-monjyu1101
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/Monjyu1101/AiDiy2026/tree/main/backend_hermes/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/Monjyu1101/AiDiy2026 --skill blender-mcp-monjyu1101

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes users need to orchestrate Blender workflows programmatically and remotely. This skill enables Hermes to control a running Blender instance over a socket, allowing automated 3D creation, material setup, and bpy scripting across sessions.

Core Features & Use Cases

  • Remote control of Blender via a socket-based MCP bridge to execute arbitrary Blender Python (bpy) code.
  • Query scene information, create objects, assign materials, animate properties, and reproduce workflows across sessions.
  • Use Case: A designer wants to procedurally generate assets by sending commands from Hermes to Blender.

Quick Start

Install the Blender MCP addon, start the socket server in Blender, and connect Hermes to port 9876 to execute bpy code.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I automate Blender 3D scene creation from external scripts?

To automate Blender 3D scene creation, this skill connects Hermes to a live Blender instance over a TCP socket, allowing you to execute arbitrary bpy Python code remotely for automated object generation and manipulation.

What Blender version is required for remote bpy scripting via socket?

Remote bpy scripting via socket requires a Blender 4.3+ desktop instance. You must install the MCP addon and start the socket server within Blender to accept incoming connections on port 9876.

How does the JSON protocol work for controlling Blender remotely?

The JSON over TCP protocol controls Blender remotely by sending structured commands like execute_code and get_scene_info. This allows external clients to execute bpy scripts and query scene information across active Blender sessions.

Can I query and modify materials in Blender without opening the GUI?

Yes, you can query scene information, create objects, assign materials, and animate properties without using the GUI by sending JSON commands over the socket bridge to execute bpy code remotely.

What are the limitations of using a socket server for Blender automation?

The socket server approach for Blender automation requires a continuously running desktop instance and relies on a simple JSON protocol, meaning it lacks built-in authentication and is primarily designed for local or trusted network workflows.