blender-mcp

Control a live Blender instance via JSON-over-TCP commands.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually operating Blender when you want an AI to generate or modify 3D scenes, materials, animations, and viewport renders from a text-driven workflow.

Core Features & Use Cases

  • Remote Blender control via TCP JSON protocol: Sends commands to a running Blender instance using a socket server.
  • Arbitrary Blender Python execution: Runs bpy code to create objects, materials, animations, and scene logic beyond fixed commands.
  • Scene inspection and quick visuals: Retrieves scene/object information and can capture viewport screenshots for verification.
  • Use case: Generate a product render pipeline by programmatically creating materials and placing objects, then rendering and screenshotting the viewport to review results before final output.

Quick Start

Start the Blender “BlenderMCP” server in your Blender session, then ask Hermes to generate a scene by sending execute_code to the running socket server on port 9876.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I control a live Blender instance to create 3D scenes from text?

Remote Blender control allows an AI to drive a live instance by sending JSON-over-TCP commands to a socket server. This removes manual operation friction by enabling text-driven workflows to generate and modify 3D scenes programmatically.

What do I need to set up before generating Blender scenes via remote control?

Before generating scenes, you must start the BlenderMCP TCP socket server on port 9876 within your Blender session. This establishes the connection needed for Hermes to send execute_code commands to the running instance.

Can I run arbitrary Blender Python scripts through remote control?

Yes, you can run arbitrary Blender Python by sending execute_code commands to the socket server. This enables bpy code execution to create objects, materials, animations, and custom scene logic beyond fixed commands.

How do I verify 3D modeling results when controlling Blender remotely?

You can verify 3D modeling results by capturing viewport screenshots through the remote JSON commands. The workflow retrieves scene and object information, allowing you to review programmatically generated materials and placements before final output.

What are the limitations of using TCP JSON commands for Blender scene generation?

Using TCP JSON commands for Blender scene generation requires a continuously running instance with the socket server active on port 9876. If the socket connection is interrupted, the remote workflow will fail to execute bpy code or receive JSON responses.