blender-mcp

Control a running Blender scene via TCP JSON socket commands.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/devMoez/titan --skill blender-mcp-devmoez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/devMoez/titan/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/devMoez/titan --skill blender-mcp-devmoez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the friction of manually controlling Blender from external workflows by enabling direct programmatic control of a running Blender session.

Core Features & Use Cases

  • Remote scene inspection: List objects in a scene and retrieve details for a specific object.
  • Automated Blender scripting: Run arbitrary Blender Python (bpy) code to create/modify objects, materials, and animations.
  • Viewport rendering support: Capture the current viewport as a screenshot for quick visual validation.
  • Use Case: Create a product mockup pipeline where an agent generates geometry, assigns materials, and renders a viewport screenshot without needing to operate Blender’s UI.

Quick Start

Use the blender-mcp Skill when you want the agent to connect to a running Blender instance and execute Blender Python over the TCP socket on 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 automate Blender bpy scripting from an external workflow?

You can automate Blender bpy scripting by sending JSON commands over a TCP socket to a running Blender instance. This allows remote execution of arbitrary Python code for automated 3D object creation, material setup, and animation keyframing without manual UI interaction.

Can I capture a viewport screenshot in Blender via remote command?

Yes, you can capture a Blender viewport screenshot by sending the get_viewport_screenshot JSON message over the TCP socket. This returns a visual capture of the current viewport, enabling quick validation of automated 3D modeling or material assignments within external pipelines.

What is needed to run Blender remote scene inspection over a TCP socket?

Blender remote scene inspection requires Blender 4.3+ with the blender-mcp addon installed and its socket server running on localhost TCP port 9876. You then send JSON messages like get_scene_info and get_object_info to retrieve scene and object details programmatically.

Does blender-mcp work with Blender on macOS and Windows?

blender-mcp requires Blender 4.3+ and communicates via localhost TCP port 9876 using JSON messages. As long as the desktop Blender instance supports the addon and the TCP socket server starts successfully, the operating system does not restrict the remote bpy execution.

How to create 3D objects and assign materials in Blender without using the UI?

To create 3D objects and assign materials without the Blender UI, send execute_code JSON messages containing your bpy Python scripts over the TCP socket on port 9876. This executes the geometry generation and material assignments directly within the active Blender scene.

Why is my Blender TCP socket connection on port 9876 not working?

If the Blender TCP socket connection on port 9876 is not working, ensure the blender-mcp addon is installed in Blender 4.3+ and its socket server is actively running. The Skill depends on localhost TCP connectivity and structured JSON messages to execute remote bpy commands successfully.