blender-mcp

Control Blender remotely via socket communication for 3D modeling tasks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables direct control of a running Blender instance through socket communication, simplifying 3D modeling, animation, and rendering workflows without manual GUI interaction.

Core Features & Use Cases

  • Create and modify 3D objects: Add meshes, change properties, and animate objects programmatically.
  • Execute arbitrary Python code: Run custom bpy scripts to perform complex tasks.
  • Use Case: An artist can automate scene setup by scripting object placement and material assignment, then render directly from the AI.

Quick Start

Connect Hermes to Blender's socket server and send JSON commands to generate or modify 3D scenes in real-time.

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 tasks without using the GUI?

You can automate Blender 3D modeling tasks by establishing a socket connection to a running Blender instance. This allows you to send JSON commands to programmatically add meshes, change properties, and execute custom bpy scripts for scene setup.

Can I execute custom Python bpy scripts remotely in Blender?

Yes, you can execute arbitrary Python bpy scripts remotely. By sending commands through a socket connection, the Skill runs your custom code directly within the Blender environment to perform complex 3D modeling and animation operations.

What is socket-based control for Blender and how does it work?

Socket-based control for Blender works by connecting an external application to Blender's plugin via a socket server. It facilitates remote control by sending JSON commands to execute bpy code, retrieve scene information, and capture viewport screenshots.

Do I need a specific Python environment to control Blender via socket?

Yes, controlling Blender via socket requires a compatible Python environment and a socket connection to Blender's plugin. You must set up this server connection to send JSON commands and automate your 3D rendering or animation workflows.

How do I retrieve scene info and capture viewport screenshots in Blender programmatically?

To retrieve scene info and capture viewport screenshots programmatically, you send specific JSON commands through the socket connection. This returns the requested scene data and renders viewport images directly from the running Blender instance.

What are the limitations of automating Blender animation via socket communication?

Automating Blender animation via socket communication is limited by the need for a continuously running Blender instance and an active socket server connection. It requires a compatible Python environment and cannot operate independently of the live application.