blender-mcp

Execute bpy code on a remote Blender instance via TCP socket.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Control a running Blender instance from Hermes via a socket connection to the blender-mcp addon, enabling creation and modification of 3D objects, materials, animations, and arbitrary bpy code without manual GUI interaction.

Core Features & Use Cases

  • Socket-based remote control: send JSON-formatted commands to a Blender MCP server to execute bpy code.
  • Scene creation and modification: create objects, assign materials, apply simple animations, and snapshot scenes.
  • Flexible integration: work with Hermes to automate Blender pipelines and rapid prototyping in 3D workflows.

Quick Start

Connect to the Blender MCP server from Hermes and start sending bpy commands.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I remotely control Blender to automate 3D object creation without using the GUI?

You can remotely control Blender by sending JSON-formatted commands over a TCP socket to execute bpy code, enabling automated creation and modification of 3D objects without manual GUI interaction.

What is a Blender MCP server and how does socket-based remote control work?

A Blender MCP server receives JSON-formatted commands via a TCP socket connection and executes bpy code against a running Blender instance, allowing external automation of 3D workflows. This socket protocol enables remote scene modification and animation control.

Can I use this to automate Blender animation and material assignment in automated pipelines?

Yes, you can automate Blender animation and material assignment by sending bpy code through the TCP socket connection. It integrates with Hermes-driven workflows to automate rapid prototyping and 3D pipeline tasks.

Do I need a specific Blender addon to enable TCP socket remote control?

Yes, you need the Blender MCP addon running in your Blender instance to accept TCP socket connections. This addon provides the JSON-based command surface that receives and executes bpy code remotely.

What's the best way to execute arbitrary bpy code on a running Blender server?

The best way to execute arbitrary bpy code on a running Blender server is through a TCP socket connection using the Blender MCP addon protocol, sending JSON-formatted commands to manipulate objects, materials, and animations.