blender-mcp

Control Blender sessions from Hermes via TCP socket with JSON commands.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/gqf2008/hermez-ai --skill blender-mcp-gqf2008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/gqf2008/hermez-ai/tree/main/skills/creative/blender-mcp
Command: npx skills add https://github.com/gqf2008/hermez-ai --skill blender-mcp-gqf2008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrate Blender control into Hermes by enabling remote, socket-based commands to a running Blender instance, allowing users to create 3D objects, apply materials, animate properties, and execute arbitrary Blender Python code on demand.

Core Features & Use Cases

  • Remote Blender control: Connect to a running Blender instance and issue commands from Hermes.
  • Create and modify scene elements: Instantiate meshes, assign materials, and alter object properties in real time.
  • Execute bpy code: Run arbitrary Python scripts within Blender to automate complex workflows.
  • Query and inspect: Retrieve scene information and object details to validate results during production or prototyping.

Quick Start

Start Blender, enable the Blender MCP addon, start the server, and instruct Hermes to send JSON commands to localhost:9876.

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 remotely using a TCP socket?

To control Blender remotely via a TCP socket, you need a running Blender instance with the MCP addon server enabled, listening on localhost port 9876 for JSON over UTF-8 commands. This setup allows real-time scene manipulation and object creation from external clients.

Can I execute arbitrary bpy code in a running Blender session from an external script?

Yes, you can execute arbitrary bpy code in a running Blender session by sending Python scripts through a TCP socket connection. This enables automated workflows, complex property animation, and direct scene modification without using the Blender interface.

What is the best way to automate 3D scene creation in Blender without using the UI?

The best way to automate 3D scene creation without the UI is by sending JSON commands over a TCP socket to a running Blender instance. This allows you to instantiate meshes, assign materials, and alter object properties programmatically.

Do I need a specific port to send JSON commands to Blender for real-time manipulation?

Yes, you need the Blender MCP addon server listening on TCP port 9876. This specific port receives JSON over UTF-8 commands to execute bpy code, query scene information, and manipulate 3D objects in real time.

Does Blender socket control support querying and inspecting scene object details?

Yes, Blender socket control supports querying and inspecting scene information. You can retrieve object details and validate production results remotely by sending specific JSON commands to the TCP server to check your 3D scene properties.