blender-mcp

Controls Blender remotely via TCP socket port 9876 using JSON messages.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill blender-mcp-yangel-hide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/Yangel-hide/video-production-planner-agent/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill blender-mcp-yangel-hide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Artists and developers can automate Blender tasks from Hermes to rapidly create or modify 3D scenes without manual UI work.

Core Features & Use Cases

  • Remote control of a running Blender instance via a socket on TCP port 9876.
  • Execute arbitrary Blender Python (bpy) code and query scene information.
  • Create and modify objects, materials, and animations from Hermes in real time.

Quick Start

Start the Blender MCP server in Blender, then connect Hermes to localhost:9876 and issue your first execute_code command.

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 JSON messages with type and params over a TCP socket on port 9876. This socket-based protocol lets you execute arbitrary bpy Python code to create or modify 3D objects, materials, and animations from an external automation client.

What do I need to set up before running Blender automation via a socket?

You need a running Blender instance with the Blender addon server started. Your automation client must then connect to localhost:9876 using the TCP socket protocol to begin sending JSON commands for remote 3D scene manipulation.

Can I execute arbitrary Blender Python code to modify 3D objects and animations?

Yes, you can execute arbitrary Blender Python (bpy) code through the socket connection. By sending execute_code commands with the required JSON message structure, you can query scene information and create or modify 3D objects, materials, and animations in real time.

Does this Blender socket protocol work across a local network for development?

Yes, the socket-based protocol operates across a local network or development setup. By connecting your client to the Blender addon server running on TCP port 9876, you can issue remote automation commands for 3D scene modification.

Why automate Blender tasks instead of using the manual UI for 3D modeling?

Automating Blender tasks via a socket protocol eliminates manual UI work, allowing artists and developers to rapidly create or modify 3D scenes. This enables real-time, programmatic control over objects, materials, and animations directly from external scripts.

What are the limitations of using a TCP socket for Blender 3D automation?

Blender 3D automation via TCP socket requires the local Blender addon server to remain actively running. Communication is limited to JSON messages with type and params fields, and all remote operations depend on a stable localhost or local network connection.