blender-mcp

Send JSON-encoded bpy commands to Blender over a TCP socket.

97|8|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/peteromallet/megaplan --skill blender-mcp-peteromallet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/peteromallet/megaplan/tree/main/megaplan/agent/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/peteromallet/megaplan --skill blender-mcp-peteromallet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Control Blender remotely from Hermes by issuing commands to a running Blender instance through the Blender MCP addon, enabling scripted creation, modification, and animation of 3D scenes.

Core Features & Use Cases

  • Remote command execution: Send JSON-encoded bpy commands over a TCP socket to perform actions in Blender.
  • Scene creation & editing: Create objects, materials, and animations programmatically to assemble scenes quickly.
  • Real-time iteration: Iterate on designs by sending successive commands and observing updates in the running Blender session.
  • Use Case: Automate setup of a simple scene with a cube, a material, and a short animation for a presentation or render sequence.

Quick Start

Install and enable the Blender MCP addon in Blender, start the socket server, then connect from Hermes and send a JSON command to execute bpy code.

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 over a TCP socket?

You can control Blender remotely by installing the Blender MCP addon, starting its TCP socket server on port 9876, and sending JSON-encoded bpy commands from Hermes to create objects, materials, and animations.

Can I automate Blender scene creation and animation using bpy commands?

Yes, you can automate Blender scene creation and animation by sending JSON-encoded bpy commands over the TCP socket to programmatically create objects, apply materials, and generate animations in your running session.

Do I need the Blender MCP addon to run bpy commands from Hermes?

Yes, remote control requires a running Blender instance with the Blender MCP addon installed and a listening TCP socket on port 9876 to receive JSON messages from Hermes.

What is the best way to iterate on a 3D design in Blender programmatically?

The best way to iterate on 3D designs programmatically is to send successive JSON commands over the TCP socket to the running Blender session, observing real-time updates to refine objects and animations immediately.

Why is my remote Blender command execution not working over the network?

Remote Blender command execution fails if the Blender instance is not running, the MCP addon is not enabled, or the TCP socket server on port 9876 is not actively listening for JSON messages.