blender-mcp

Execute bpy code and manipulate scene objects in Blender via TCP socket.

Updated May 11, 2026
One-click install
npx skills add https://github.com/jason660519/Project-Manager --skill blender-mcp-jason660519
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/jason660519/Project-Manager/tree/main/hermes-agent/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/jason660519/Project-Manager --skill blender-mcp-jason660519

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Control a running Blender instance from Hermes via socket on TCP port 9876 using the Blender MCP addon, enabling rapid creation and modification of 3D scenes without leaving Hermes.

Core Features & Use Cases

  • Remote control of Blender: Send bpy code and commands to create objects, materials, animations, and scene changes.
  • Simple protocol: JSON over TCP for reliable, language-agnostic communication.
  • Common workflows: Automate asset creation for prototypes, batch scene generation, and rapid iteration of visual storytelling.

Quick Start

Connect Hermes to a running Blender MCP server and start sending commands to create objects, modify materials, or run bpy code.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I execute bpy code to manipulate 3D scene objects in Blender remotely?

You can execute arbitrary bpy code remotely by connecting to a running Blender instance via a socket protocol on TCP port 9876. This sends JSON messages to create or modify 3D assets, materials, and animations programmatically.

What is needed to automate 3D asset creation in Blender from an external script?

Automating 3D asset creation requires a running Blender instance with the Blender MCP addon active on TCP port 9876. This enables a JSON-based messaging protocol to send commands and execute code for batch scene generation.

Can I get scene and object info from Blender using a socket protocol?

Yes, the socket protocol supports commands like get_scene_info and get_object_info. These retrieve current scene data and object details from the running Blender instance via straightforward JSON-based messaging.

Does Blender remote control work for batch scene generation and rapid iteration?

Remote Blender control is designed for batch scene generation and rapid iteration of visual storytelling. It sends bpy code and commands over a simple JSON TCP protocol to reliably create objects and modify materials without leaving your environment.

Why use a JSON over TCP protocol for 3D scripting in Blender?

Using JSON over TCP provides reliable, language-agnostic communication between external scripts and Blender. This simple protocol ensures straightforward messaging to execute code and manipulate scene objects without complex API integrations.

When should I not use remote socket control for Blender 3D modeling?

You should avoid remote socket control if your workflow requires manual GUI-based sculpting or lacks a running Blender instance. The protocol depends on an active TCP connection on port 9876 to execute bpy code and manipulate scenes.