blender-mcp

Control a running Blender instance via JSON commands over TCP.

4|Updated May 18, 2026
One-click install
npx skills add https://github.com/ZardLi1115/zedclaw --skill blender-mcp-zardli1115
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/ZardLi1115/zedclaw/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill blender-mcp-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill removes the friction of manually operating Blender by letting you create and modify 3D content from ZedClaw through a simple socket-based command interface.

Core Features & Use Cases

  • Run Blender Python (bpy) remotely: Execute arbitrary Blender scripts to generate objects, edit properties, and automate workflows.
  • Inspect scenes and objects: List scene objects and retrieve details about specific objects for iterative, tool-driven creation.
  • Capture viewport output: Generate quick viewport screenshots to verify results without exporting full renders.
  • Use case: When you need to quickly prototype a model (e.g., generate multiple variations of a mesh with different materials and keyframes), you can drive Blender from ZedClaw repeatedly rather than clicking through steps.

Quick Start

Start the BlenderMCP socket server in your running Blender session, then send an execute_code command to run bpy logic that creates your desired objects and materials.

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 scene creation from an external agent?

Remote Blender automation works by sending JSON commands over a TCP socket connection. The running Blender instance receives these commands to execute bpy scripts, generate objects, and assemble scenes without manual UI interaction.

Can I run Python bpy scripts remotely to modify 3D models?

Yes, you can run Python bpy scripts remotely by sending the execute_code command over the TCP socket. This executes arbitrary bpy logic to generate meshes, edit object properties, and automate 3D modeling workflows.

Do I need a specific Blender version to enable socket control?

Yes, socket control requires Blender 4.3 or newer. You must have the desktop instance running with the blender-mcp addon enabled and an open TCP server on port 9876 to receive external commands.

How do I get viewport screenshots to verify 3D scene changes?

Get viewport screenshots by sending the get_viewport_screenshot command over the TCP connection. This generates a quick visual output of the current 3D scene to verify modeling results without waiting for a full render.

What commands are available for inspecting objects in a Blender scene?

Available commands for inspecting objects include get_scene_info and get_object_info. These retrieve a list of scene objects and specific object details respectively, enabling iterative, tool-driven 3D creation.

Why automate 3D modeling with socket commands instead of using the Blender UI?

Automating 3D modeling with socket commands removes the friction of manual UI operations. It allows you to quickly prototype models, generate multiple mesh variations with different materials, and drive Blender repeatedly from an external agent.