blender-mcp

Controls Blender remotely via TCP socket to automate modeling and animation tasks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill bridges the gap between Hermes and Blender, allowing you to automate 3D modeling, animation, and scene management tasks without manually navigating the Blender interface.

Core Features & Use Cases

  • Automated 3D Creation: Programmatically generate meshes, apply materials, and set up complex scenes using Python.
  • Remote Control: Execute arbitrary bpy code via a socket connection to a running Blender instance.
  • Use Case: You can instruct the agent to create a series of primitive objects, apply specific colors, and set up keyframe animations for a 3D presentation, all through simple chat commands.

Quick Start

Use the blender-mcp skill to clear the current scene and add a sphere at the origin.

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 3D modeling and animation tasks without using the UI?

You can automate Blender 3D modeling and animation by executing arbitrary bpy Python scripts through a TCP socket interface. This enables remote control of meshes, materials, and rendering pipelines without navigating the interface.

Can I control Blender remotely via natural language commands?

Yes, you can control Blender remotely by instructing the agent using natural language chat commands. The agent translates your requests into bpy Python code and executes it via a socket connection to the running Blender instance.

Do I need a specific environment setup to use Blender remote control?

Yes, Blender remote control requires a persistent Blender instance running with the blender-mcp addon enabled on port 9876. This establishes the necessary TCP socket connection for executing automation scripts.

What is the best way to programmatically set up complex 3D scenes in Blender?

The best way to programmatically set up complex 3D scenes is to execute arbitrary bpy code via a socket connection. This allows you to generate meshes, apply specific colors, and set up keyframe animations for presentations.

How does executing bpy Python scripts via a socket connection work?

Executing bpy Python scripts via a socket connection works by sending arbitrary code to a persistent Blender instance. This facilitates remote manipulation of scene objects, materials, and rendering pipelines directly from an external agent.

Are there limitations when automating 3D creation through a TCP socket in Blender?

Automating 3D creation through a TCP socket is limited by the need for a persistent Blender instance. If the blender-mcp addon is not enabled on port 9876, the socket connection fails and remote script execution is not possible.