blender-mcp

Execute Blender Python (bpy) code via socket to create, modify, and animate 3D objects, materials, and scenes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to directly control Blender through a socket connection, enabling the creation and modification of 3D objects, materials, animations, and execution of arbitrary Blender Python code.

Core Features & Use Cases

  • 3D Modeling: Create and modify 3D objects directly within Blender.
  • Material and Animation Control: Customize materials and animate objects using Python scripts.
  • Script Execution: Run custom Blender Python (bpy) code for advanced operations.
  • Use Case: Ideal for automating complex Blender tasks or integrating Blender into larger workflows.

Quick Start

Start the socket server in Blender and then run the following command in Hermes: blender_exec("bpy.ops.mesh.primitive_cube_add(size=1, location=(0, 0, 0))")

Frequently Asked Questions about blender-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute Blender Python scripts to automate 3D modeling tasks?

You can execute Blender Python scripts by sending bpy code through a socket connection. This allows direct control over Blender instances to create, modify, and animate 3D objects and materials in production workflows.

Can I control Blender materials and animations using Python code?

Yes, you can control Blender materials and animations using Python code. By executing custom bpy scripts via the socket connection, you can customize materials and animate 3D objects directly within your Blender scene.

How do I connect to a running Blender instance to run Python commands?

To connect to a running Blender instance, start the socket server in Blender 4.3 or later. Once the server is active, you can send arbitrary bpy code strings like primitive_cube_add from your external client to execute commands.

Does this Blender automation approach require a specific Blender version?

Yes, this Blender automation approach requires Blender version 4.3 or later. It directly interacts with these instances via a socket connection to support arbitrary Blender Python code execution for 3D scene modification.

What is the best way to integrate Blender 3D modeling into a larger automated workflow?

The best way to integrate Blender 3D modeling into a larger automated workflow is using a socket connection for direct bpy code execution. This enables automated creation and modification of 3D objects and scenes without manual GUI interaction.

Are there limitations when executing arbitrary bpy code through a socket connection?

Executing arbitrary bpy code through a socket connection supports advanced operations but requires a running Blender 4.3+ instance. It is ideal for automating complex tasks, though operations are bound by the capabilities and constraints of the bpy Python API.