blender-mcp

Control a running Blender instance via a TCP socket connection.

78|16|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/sheawinkler/hermes-agent-ultra --skill blender-mcp-sheawinkler
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/sheawinkler/hermes-agent-ultra/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/sheawinkler/hermes-agent-ultra --skill blender-mcp-sheawinkler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables programmatic control of a running Blender instance from Hermes, enabling automation of 3D creation, materials, and animation workflows.

Core Features & Use Cases

  • Remote control of Blender MCP: drive a Blender session from Hermes to create objects, assign materials, and set up scenes.
  • Execute arbitrary bpy code: run custom Python scripts inside Blender via the MCP socket.
  • Automate workflows: batch scene generation, animation setups, and reproducible tutorials across desktop deployments.

Quick Start

Start the Blender MCP server in Blender, then 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 3D scene creation from an external script?▼

You can automate Blender 3D scene creation by using a TCP socket connection to drive a running Blender session, sending JSON-based bpy commands to create objects and assign materials remotely.

Can I execute custom bpy Python scripts inside Blender remotely?▼

Yes, you can execute arbitrary bpy Python scripts inside Blender remotely by sending them through a MCP socket server listening on port 9876, allowing full programmatic control over the desktop instance.

Do I need a specific Blender version to use a TCP socket server for automation?▼

Yes, automating Blender via a TCP socket server requires the desktop version of Blender 4.3 or higher, along with the blender-mcp addon installed and running to handle the connection protocol.

What is the best way to batch generate 3D scenes across desktop Blender deployments?▼

The best way to batch generate 3D scenes across desktop deployments is by connecting an external controller like Hermes to localhost:9876, issuing bpy commands over a JSON-based TCP protocol to automate workflows.

Why does my Blender MCP socket connection fail to automate scene creation?▼

Blender MCP socket automation fails if the blender-mcp addon is not installed, Blender is below version 4.3, or the TCP socket server is not actively listening on port 9876 for the JSON protocol.