blender-mcp

Control Blender remotely by executing bpy code over a TCP socket.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes users need to orchestrate Blender tasks without switching tools, enabling Blender control from Hermes over a network socket to automate object creation, material setup, and bpy scripting.

Core Features & Use Cases

  • Remote control of a running Blender instance via the blender-mcp addon to create objects, materials, and animations.
  • Execute arbitrary bpy code and query scene information to automate workflows and prototyping.
  • Use Case: Generate a scene with multiple cubes and a simple animation purely from chat-driven prompts.

Quick Start

Connect Hermes to a running Blender MCP server and issue a single command to initialize a scene.

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 from an external script over a network socket?

Automating Blender over a network socket requires the blender-mcp addon running on a TCP server. Hermes connects to this server to execute arbitrary bpy code and manage scene content remotely.

Can I run arbitrary bpy code in Blender from Hermes?

Yes, you can run arbitrary bpy code in Blender from Hermes by sending JSON commands over a TCP 9876 socket. This allows you to script object creation, material setup, and animations directly from chat-driven prompts.

Do I need a specific Blender addon enabled to control scenes remotely?

Yes, you need the blender-mcp addon enabled and a running server in your Blender installation. This addon listens on TCP port 9876 to receive JSON commands and execute scene management tasks.

What is the best way to batch generate 3D objects and animations in Blender?

Batch generating 3D objects and animations is best handled by automating Blender control via a TCP socket. This approach allows you to script the creation of multiple scene elements and simple animations across projects.

Does Blender MCP support querying scene information during a chat-driven session?

Yes, Blender MCP supports querying scene information during a session. Hermes sends JSON requests over the TCP socket to retrieve current scene data and execute arbitrary bpy code for workflow automation.

Why is my Blender MCP connection not working over the network?

Blender MCP connection issues usually occur because the blender-mcp addon server is not running or accessible. Ensure Blender is open, the addon is enabled, and communication over TCP port 9876 is not blocked.