blender-mcp

Execute bpy code and retrieve scene data from Blender over JSON-over-TCP.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Controlling a running Blender session from Hermes eliminates manual context switching and enables automated 3D workflows by issuing commands over a lightweight socket.

Core Features & Use Cases

  • Remote execution of arbitrary Blender Python (bpy) code via a simple JSON-over-TCP protocol.
  • Retrieve scene information, object data, and viewport screenshots to drive automation and analytics.
  • Automate modeling, animation, and material pipelines by scripting Blender from Hermes.

Quick Start

Install and enable the Blender MCP addon in Blender, start the server, and connect Hermes 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 automate Blender workflows from a remote script?

You can automate Blender workflows by using a JSON-over-TCP protocol to execute bpy code remotely. This Skill connects to a running Blender instance via a localhost socket to issue commands and capture viewport data.

What do I need to run bpy code remotely in Blender?

To run bpy code remotely, you need Blender 4.3 or later installed on a desktop, the Blender MCP addon loaded and started, and a listening TCP socket active on localhost:9876.

Can I retrieve scene information and viewport screenshots from Blender via a socket?

Yes, retrieving scene information and capturing viewport screenshots via socket is supported. The connection exposes a JSON-over-TCP protocol to inquire about object data and capture viewport screenshots for automated 3D workflows.

Does Blender remote control work for automating modeling and animation pipelines?

Yes, Blender remote control works for automating modeling and animation pipelines. By scripting bpy code execution from Hermes, you can automate material assignments, object creation, and scene manipulation without manual context switching.

Why is my Blender socket connection not working on localhost:9876?

Your Blender socket connection may not work if the Blender MCP addon is not enabled or the server is not started. This Skill requires Blender 4.3+ with the addon actively listening on localhost:9876 for Hermes to connect successfully.

What is the best way to control a running Blender session from an external application?

The best way to control a running Blender session is via a lightweight JSON-over-TCP socket. This approach allows an external application like Hermes to execute arbitrary Python code and query scene information directly in the active Blender instance.