blender-mcp

Control a running Blender instance remotely via TCP socket.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/jleechanorg/hermes-agent --skill blender-mcp-jleechanorg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/jleechanorg/hermes-agent/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/jleechanorg/hermes-agent --skill blender-mcp-jleechanorg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Blender automation and remote control from Hermes enables rapid creation and modification of 3D scenes by sending commands to a running Blender instance via the blender-mcp addon. This streamlines asset creation, prototyping, and iterative design without manual GUI interaction.

Core Features & Use Cases

  • Remote control of a Blender instance via TCP socket.
  • Execute arbitrary Blender Python (bpy) code and manipulate objects, materials, and animations.
  • Use Case: Automate repetitive Blender tasks such as creating a grid of objects with varied materials, driven by AI prompts.

Quick Start

Start Blender with the blender-mcp addon, connect Hermes to localhost:9876, and issue bpy commands to create or modify objects.

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 scene creation and object manipulation via remote control?

Blender scene creation and object manipulation can be automated by sending remote control commands to a running Blender instance via a TCP socket using the blender-mcp addon, allowing you to execute arbitrary bpy Python code without manual GUI interaction.

Do I need a specific Blender version to control 3D scenes via TCP socket?

Yes, controlling 3D scenes via TCP socket requires Blender 4.3 or higher running as a desktop instance alongside the installed blender-mcp addon to properly receive and execute remote commands from Hermes.

What Blender operations can I execute remotely for 3D asset creation and animation setup?

Remote 3D asset creation and animation setup operations include executing arbitrary Python code, manipulating objects, assigning materials, and retrieving scene information or viewport screenshots across active Blender sessions via supported commands.

What is the best way to connect Hermes to Blender for executing bpy commands?

The best way to connect Hermes to Blender for executing bpy commands is to start Blender with the blender-mcp addon active, connect Hermes to localhost:9876, and issue Python code to modify objects, materials, or animations directly.

Can I get viewport screenshots and object information from a running Blender instance?

Yes, you can get viewport screenshots and object information from a running Blender instance by issuing the get_viewport_screenshot and get_object_info commands through the TCP socket connection to retrieve current scene state data.