blender-mcp

Control a running Blender instance over TCP to execute bpy code.

Updated May 3, 2026
One-click install
npx skills add https://github.com/JuanMS20/solviora-agent --skill blender-mcp-juanms20
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/JuanMS20/solviora-agent/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/JuanMS20/solviora-agent --skill blender-mcp-juanms20

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Allows remote control of a running Blender instance from Hermes via a socket connection to the blender-mcp addon, enabling creation and modification of objects, materials, animations, and the execution of arbitrary Blender Python (bpy) code.

Core Features & Use Cases

  • Remote control of a running Blender instance via TCP socket
  • Execute arbitrary bpy code and query scene information
  • Create, modify, and animate objects and materials within Blender

Quick Start

Start the Blender MCP addon server inside Blender, then connect Hermes to localhost:9876 to begin sending bpy commands.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I control a running Blender instance remotely over a network?▼

You can control a running Blender instance remotely by establishing a TCP socket connection to send JSON-formatted commands. This allows you to execute bpy code and manage scene objects from an external automation system.

How does automated scene creation in Blender work via a socket connection?▼

Automated scene creation via a socket connection works by sending plain UTF-8 JSON commands, like execute_code, to a running Blender instance. This triggers bpy scripts that programmatically generate objects, apply materials, and sequence animations.

Can I execute arbitrary bpy code in Blender from an external automation tool?▼

Yes, you can execute arbitrary bpy code by sending an execute_code command through a TCP socket. This enables remote management of scene objects, material setup, and animation sequencing directly from your automation workflow.

Do I need a specific addon to start sending remote commands to Blender?▼

Yes, you need to start the Blender MCP addon server inside Blender first. Once the local server is running, you can connect your automation client to localhost:9876 to begin transmitting JSON commands.

What is the best way to query Blender scene information during an automation workflow?▼

The best way to query scene information during automation is using the get_scene_info and get_object_info commands. These JSON-based TCP requests retrieve current scene data and object properties from the running Blender instance.

What are the limitations of using a TCP socket for Blender automation?▼

Using a TCP socket for Blender automation requires a running Blender instance and an active addon server. It operates using a plain UTF-8 JSON protocol, meaning automation workflows are dependent on a stable local network connection.