blender-mcp

Control a running Blender instance via TCP socket to execute bpy Python code.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill bridges the gap between AI agents and 3D design software, allowing you to automate complex modeling, animation, and rendering tasks in Blender without manual interface navigation.

Core Features & Use Cases

  • Direct Scene Control: Programmatically create, modify, and delete 3D objects, materials, and animations.
  • Automated Rendering: Execute Python scripts to render scenes or capture viewport screenshots automatically.
  • Use Case: You can instruct the agent to generate a series of primitive shapes, apply custom materials, and render the final scene to a file, significantly accelerating your 3D prototyping workflow.

Quick Start

Use the blender-mcp skill to add a new UV sphere at the origin and apply a blue material to it.

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 scene manipulation via natural language?

Blender 3D scene manipulation is automated by connecting an AI agent to a running Blender instance via a TCP socket interface on port 9876. This allows you to control modeling and animation tasks without manual interface navigation.

Can I execute arbitrary bpy Python code for 3D modeling through an AI agent?

Yes, executing arbitrary bpy Python code for 3D modeling is supported. The Skill sends Python scripts to the running Blender session, allowing the agent to programmatically create, modify, and delete 3D objects and materials.

Do I need a persistent Blender session running to use remote 3D control?

A persistent Blender session is required to use remote 3D control. You must have Blender running on your desktop environment with the blender-mcp addon enabled on port 9876 for the AI agent to connect.

How do I automate rendering scenes and capturing viewport screenshots in Blender?

Automating rendering scenes and capturing viewport screenshots in Blender is done by instructing the agent to execute Python scripts. The AI sends commands through the TCP socket to render the final scene to a file automatically.

What are the limitations of using TCP socket control for Blender animation tasks?

TCP socket control for Blender animation tasks requires a persistent desktop Blender session and the specific addon enabled on port 9876. It cannot operate independently in a headless environment and depends on a live TCP connection.