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.