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.