blender-mcp

Control Blender 3D scenes by executing bpy Python scripts over TCP.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill bridges the gap between AI agents and 3D production, allowing users to manipulate Blender scenes, generate geometry, and automate rendering tasks without manual interface navigation.

Core Features & Use Cases

  • Direct Scene Control: Execute arbitrary Python (bpy) code to create, modify, or delete 3D objects.
  • Automated Rendering: Trigger viewport screenshots or full renders programmatically.
  • Use Case: A user can ask the agent to generate a series of primitive shapes, apply materials, and render the scene to a file, streamlining the 3D prototyping workflow.

Quick Start

Ask the agent to clear the current scene and add a new UV sphere at the origin using the blender-mcp skill.

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 3D via natural language for automated modeling?

To control Blender 3D via natural language, this skill uses a TCP socket interface to execute bpy Python scripts, allowing you to generate geometry and manipulate scenes programmatically. It requires a running Blender instance with the blender-mcp addon configured on port 9876.

Do I need a running Blender instance to use bpy scripts for 3D automation?

Yes, you need a running Blender instance to execute bpy scripts for 3D automation. The skill connects to a TCP socket interface on port 9876, which requires the blender-mcp addon to be actively configured within your local Blender environment.

Can I automate 3D rendering and trigger viewport screenshots programmatically?

You can automate 3D rendering and trigger viewport screenshots programmatically by sending arbitrary bpy Python code through the TCP socket interface. This allows you to manipulate scene objects, apply materials, and render scenes directly to a file.

What is the best way to automate scene manipulation and generate 3D objects in Blender?

The best way to automate scene manipulation and generate 3D objects in Blender is by executing arbitrary Python code via a TCP socket connection. This approach bypasses manual interface navigation, allowing you to create, modify, or delete scene objects directly.

Are there limitations when executing arbitrary Python scripts to manipulate Blender scenes?

Limitations when executing arbitrary Python scripts to manipulate Blender scenes include the strict dependency on a running Blender instance and a specific TCP socket configuration on port 9876. Without this local environment actively connected, the skill cannot execute any bpy commands.