blender-mcp

Control a running Blender instance by executing Blender Python over a TCP socket.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually operating Blender for 3D scene creation and edits by letting you drive a running Blender instance through a simple TCP JSON protocol.

Core Features & Use Cases

  • Direct Blender control via socket: Send JSON commands to a Blender MCP server running inside Blender.
  • Automated scene operations: Query scene objects and retrieve object details for planning and iteration.
  • Arbitrary bpy execution: Run Blender Python (bpy) code to create 3D objects, materials, animations, and custom logic.
  • Viewport screenshot capture: Generate a quick visual reference of the current viewport.

Quick Start

Install the Blender MCP addon in your Blender session, start the BlenderMCP socket server, then ask your agent to execute bpy Python code through the TCP port 9876.

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 remotely to automate 3D scene creation?

You can control Blender remotely by sending UTF-8 JSON messages over a TCP socket to execute Blender Python (bpy) code. This requires a running Blender instance with an MCP addon server listening on TCP port 9876.

Can I run arbitrary Blender Python code through a TCP connection?

Yes, you can execute arbitrary bpy code through the TCP JSON protocol. This allows you to programmatically create 3D objects, set up materials, apply animation keyframing, and run custom logic within the active Blender session.

What do I need to set up before using a TCP JSON protocol to modify Blender scenes?

You need to install the Blender MCP addon in your desktop Blender session and start the BlenderMCP socket server. Once the server is running, your agent can connect to TCP port 9876 to send JSON commands.

How does automated scene inspection work when driving Blender programmatically?

Automated scene inspection works by sending JSON query commands to retrieve details about scene objects. This allows you to gather object information for planning and iteration before executing further bpy modifications.

Can I capture a viewport screenshot to verify 3D modeling changes made via remote control?

Yes, you can capture a viewport screenshot to generate a quick visual reference. This verifies the current state of your 3D scene after executing remote modeling or material setup commands.