blender-mcp

Control Blender via TCP to create 3D assets and retrieve scene data.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill blender-mcp-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/Signmanal/VIGIL/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/Signmanal/VIGIL --skill blender-mcp-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually switching between VIGIL and Blender to build, edit, or animate 3D assets breaks workflow efficiency for analysts, researchers, and creators using VIGIL.

Core Features & Use Cases

  • Direct Blender Control: Send commands to a running local Blender instance via TCP socket to create 3D objects, assign custom materials, and run arbitrary bpy Python code.
  • Scene Management: Retrieve full scene object lists, view detailed object properties, and capture viewport screenshots directly from VIGIL.
  • Use Case: A security researcher can build a 3D model of a physical attack surface documented in an investigation report without leaving their VIGIL session.

Quick Start

Use the blender-mcp skill to create a 3D cube with a blue matte material in the active Blender scene.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I control Blender from VIGIL for 3D asset creation?

The blender-mcp integration allows you to control Blender directly from VIGIL by sending bpy Python commands via a TCP socket connection on port 9876. This eliminates context switching for 3D asset creation, scene editing, and animation tasks within active VIGIL sessions.

Do I need a specific Blender version to run bpy commands through a TCP socket?

Yes, executing bpy commands via the TCP socket requires a running local Blender 4.3+ desktop instance. You must also have the blender-mcp addon actively running and listening on TCP port 9876 to establish the VIGIL connection.

Can I retrieve scene object lists and viewport screenshots from Blender without leaving VIGIL?

Yes, you can retrieve full scene object lists, view detailed object properties, and capture viewport screenshots directly from VIGIL. The integration manages scene data retrieval and viewport capture over the established TCP socket connection.

How does 3D modeling integration apply to security operations documentation?

3D modeling integration applies to security operations by enabling analysts to build physical attack surface models and threat artifact visualizations within investigation reports. Security researchers can document findings without leaving their active VIGIL session.

What are the limitations of managing Blender scenes from VIGIL?

A key limitation is the strict dependency on a local desktop environment; the integration requires a running local Blender 4.3+ instance with the addon active on TCP port 9876. It cannot execute bpy commands or retrieve scene data without this local connection.