blender-mcp

Control a running Blender instance via TCP socket to execute bpy code and query scene information.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Control a Blender instance from Hermes to automate 3D creation, modification, and scripting without manual switching between tools. This enables artists and developers to drive Blender workflows from the Hermes platform, reducing context switching and streamlining pipelines.

Core Features & Use Cases

  • Remote socket control of a running Blender instance via the Blender MCP addon.
  • Execute arbitrary bpy Python code, inspect scenes and objects, and retrieve render-ready data.
  • Use cases include automating object creation, material setup, animations, and batch rendering initiated from Hermes.

Quick Start

Connect Hermes to the Blender MCP socket and start sending execute_code or scene queries to automate Blender from Hermes.

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 scene creation from an external script?

You can remote control Blender via a TCP socket connection to execute bpy code and modify 3D scenes. This enables external platforms to send commands and automate scene creation directly.

Can I run arbitrary bpy Python code in Blender from another application?

Yes, you can execute arbitrary bpy Python code in Blender remotely using the execute_code command over a TCP socket. This returns structured results, enabling seamless automation and integration from external tools.

Do I need a specific addon to enable remote control of Blender?

Yes, you need to install the Blender MCP addon on your target Blender instance to enable remote control. This addon facilitates the TCP socket connection and processes the JSON protocol commands sent from external platforms.

What commands are supported for querying scene information in Blender remotely?

Supported commands for querying scene information remotely include get_scene_info, get_object_info, and get_viewport_screenshot. These commands use a JSON protocol to return structured data about the 3D scene and its objects.

How does TCP socket integration streamline 3D modeling workflows?

TCP socket integration streamlines 3D modeling workflows by allowing external platforms to initiate object creation, material setup, and batch rendering directly. This reduces context switching between tools and automates repetitive pipeline tasks.