blender-mcp

Control a running Blender instance remotely via TCP socket with JSON.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge --skill blender-mcp-chris-chai-minjae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge --skill blender-mcp-chris-chai-minjae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This integration enables remote, programmable control of a running Blender instance from Hermes, allowing automated scene creation, material setup, and animation workflows.

Core Features & Use Cases

  • Communicate with Blender via a TCP socket to execute arbitrary bpy code
  • Create and modify 3D objects, materials, and animations programmatically
  • Retrieve scene information and object details for batch processing and repeated tasks

Quick Start

Install the Blender MCP addon, start the server inside Blender, and verify the connection using netcat.

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 from a remote script?

You can automate Blender scene creation by sending arbitrary bpy code over a TCP socket. This allows a remote system to execute Python scripts for automated object generation and scene setup.

Can I run Blender headless with this MCP socket connection?

No, a headless Blender instance is not supported. You must run the desktop Blender 4.3+ application with the Blender MCP addon installed and the TCP server actively started inside the interface.

How do I execute arbitrary bpy code to modify 3D objects via a TCP socket?

You execute bpy code by sending plain UTF-8 JSON commands over a TCP socket. This sends instructions to the running Blender instance to create, modify, or query 3D objects and materials programmatically.

What is the protocol used for remote Blender automation?

The remote Blender automation uses a TCP socket-based protocol communicating with plain UTF-8 JSON. This mechanism transmits bpy commands and receives scene information responses.

Does this remote Blender control support batch animation workflows?

Yes, the socket integration supports batch animation workflows. You can programmatically create and modify animations by sending sequential bpy commands over the TCP connection for batch processing.

Why do I need the Blender MCP addon to control 3D scenes externally?

The Blender MCP addon is required to start the local TCP server inside the desktop application. Without it, the running instance cannot listen for incoming JSON commands or execute remote bpy scripts.