blender-mcp

Control a Blender session remotely via TCP socket with JSON commands.

150|25|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/Devsoul2026/Hermes-One-Click --skill blender-mcp-devsoul2026
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/Devsoul2026/Hermes-One-Click/tree/main/hermes-agent/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/Devsoul2026/Hermes-One-Click --skill blender-mcp-devsoul2026

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Control a running Blender instance from Hermes via a socket to create objects, apply materials, run arbitrary bpy code, and drive scenes without leaving the Hermes UI.

Core Features & Use Cases

  • Remote bpy execution: send JSON commands to execute code, query scene info, and fetch object details.
  • Scene automation: create, modify, and animate objects, materials, and render outputs from Hermes workflows.
  • Use Case: Model a chair by sending bpy code to generate meshes and materials, then render a quick viewport image.

Quick Start

Install the Blender MCP addon in Blender, start the socket 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 control Blender remotely to automate 3D object creation and scene setup?

Remote Blender control is achieved by sending JSON commands over a UTF-8 TCP socket on port 9876. This requires a running Blender instance with the Blender MCP addon to execute bpy scripts, apply materials, and automate scene setup.

Can I run bpy scripts in Blender from an external application on Windows, macOS, and Linux?

Yes, you can execute bpy scripts externally across Windows, macOS, and Linux desktop environments. The connection uses a TCP socket server on localhost:9876 to transmit JSON commands for executing arbitrary bpy code and querying scene information.

What do I need to connect to a Blender session and start sending bpy commands?

To connect and send bpy commands, you need the Blender MCP addon installed and its socket server running. Your external client then connects to localhost:9876 and transmits UTF-8 encoded JSON commands to execute scripts and fetch object details.

Does remote Blender automation support rendering and animation workflows?

Remote Blender automation supports animation and rendering workflows. You can send JSON commands via the socket connection to create and animate objects, modify materials, and generate viewport render outputs directly from your external application.

Why is my Blender socket connection failing to execute bpy code?

Bpy code execution fails if the Blender MCP addon is not installed or the TCP socket server is not running on port 9876. Ensure Blender is open, the addon server is active, and your client sends correctly formatted UTF-8 JSON commands.