blender-mcp

Automate Blender workflows from Colony via JSON over TCP.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Aevonix/colony-ai --skill blender-mcp-aevonix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/Aevonix/colony-ai/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/Aevonix/colony-ai --skill blender-mcp-aevonix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate Blender workflows by driving a running Blender instance from Colony through a simple TCP socket protocol, enabling programmatic creation, modification, and animation of 3D scenes.

Core Features & Use Cases

  • Remote control: execute arbitrary Blender Python (bpy) code on a live Blender session from Colony.
  • Scene inspection and manipulation: query scene objects, list objects, and modify materials or transforms.
  • Use case: automate asset creation pipelines or rapid prototyping by scripting Blender tasks from Colony.

Quick Start

Start the Blender MCP server inside Blender, then connect from Colony and send JSON commands to control Blender.

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 workflows from an external script?

You can automate Blender workflows by sending plain UTF-8 JSON commands over a TCP socket from external scripts to a running Blender instance, enabling programmatic 3D scene creation, modification, and animation.

Can I execute arbitrary Blender Python bpy code remotely?

Yes, you can execute arbitrary Blender Python bpy code remotely by sending the execute_code command via the TCP socket protocol to a live Blender session running the required addon.

How do I query scene objects in Blender from an automated pipeline?

You query scene objects in Blender from an automated pipeline by sending JSON commands like get_scene_info or get_object_info over the TCP socket to retrieve object lists, materials, and transforms.

Do I need a specific Blender addon to control it via TCP socket?

Yes, you need a running Blender instance with the blender-mcp addon installed and started, which acts as the server receiving JSON commands from Colony to manipulate the 3D scene.

Can I capture a viewport screenshot from Blender through automated scripting?

Yes, you can capture a viewport screenshot from Blender through automated scripting by sending the get_viewport_screenshot command through the TCP socket connection.

What is the best way to batch process 3D scene modifications in Blender?

The best way to batch process 3D scene modifications in Blender is using a TCP socket protocol to drive a live session, allowing automated scripts to rapidly prototype or manipulate assets programmatically.