blender-mcp

Control a running Blender instance via TCP JSON commands.

19|4|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill blender-mcp-carterwayneskhizeine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/carterwayneskhizeine/hermes-agent-windows-R/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill blender-mcp-carterwayneskhizeine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of manually switching between Hermes and Blender to create or modify 3D content, by enabling control of a live Blender session through a simple TCP JSON interface.

Core Features & Use Cases

  • Remote Blender scene control: Execute Blender Python (bpy) code to add or edit objects, materials, and animations in a running desktop instance.
  • Scene introspection: Retrieve scene and object details to support iterative, AI-guided creation workflows.
  • Viewport capture: Get a screenshot of the current viewport for quick review and verification.

Quick Start

Start the socket server inside Blender (Blender viewport sidebar → BlenderMCP tab → Start Server) and confirm port 9876 is open before sending execute_code requests from Hermes.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I control a running Blender instance remotely via TCP?

Remote Blender control is achieved by sending MCP-style TCP JSON messages to execute bpy code, modify 3D scenes, and set up materials through a live desktop connection on port 9876.

What do I need to run AI-driven Blender scene creation and animation workflows?

AI-driven Blender workflows require a desktop Blender 4.3+ instance with the blender-mcp addon running a TCP server on port 9876 to process execute_code and scene inspection requests.

Can I capture a Blender viewport screenshot through an external script?

Viewport screenshot capture is supported via TCP JSON messaging, allowing an external AI agent to request and retrieve visual verification of the current 3D scene state.

How does an AI agent inspect Blender scene objects programmatically?

Scene introspection is handled by retrieving scene and object details through specific TCP JSON commands, enabling iterative AI-guided creation workflows to query running Blender instances.

Why is my Blender TCP connection not working for 3D modeling commands?

Blender TCP connection issues often occur when the socket server is not started inside the Blender viewport sidebar or when port 9876 is blocked, preventing execute_code requests.