blender-mcp

Send JSON commands over TCP to control Blender via bpy.

Updated May 2, 2026
One-click install
npx skills add https://github.com/AlvaroBiano/hermes-agent --skill blender-mcp-alvarobiano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/AlvaroBiano/hermes-agent/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/AlvaroBiano/hermes-agent --skill blender-mcp-alvarobiano

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes-driven automation requires direct, remote control of a running Blender session to create, modify, and script scenes without manual GUI interaction.

Core Features & Use Cases

  • Remote control of a running Blender instance via a TCP socket to execute bpy code and query scene data.
  • Programmatic creation and modification of objects, materials, and animations, plus on-demand viewport results for validation.
  • Use Case: A designer automates scene setup and renders iterations by sending bpy commands from Hermes and receiving live scene information.

Quick Start

Start the Blender MCP addon, run the socket server inside Blender, then send a JSON command from Hermes 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 a running Blender instance remotely via a socket?

You can control a running Blender instance remotely by using a TCP socket on localhost:9876 to send JSON commands that execute bpy code and query scene data without manual GUI interaction.

What do I need to automate Blender scene creation from an external script?

Automating Blender scene creation from an external script requires the Blender MCP addon, a listening TCP socket on localhost:9876, and the ability to send and receive JSON messages using the defined protocol.

Can I execute bpy code and modify objects in Blender without using the GUI?

Yes, you can execute bpy code and programmatically modify objects, materials, and animations without the GUI by sending JSON commands over a TCP socket to a running Blender session.

Does remote Blender automation support querying live scene data?

Yes, remote Blender automation supports querying live scene data and returning on-demand viewport results for validation by sending and receiving JSON messages through the TCP socket connection.

What are the limitations of automating Blender via a localhost TCP socket?

A limitation of automating Blender via a localhost TCP socket is that it requires a running Blender instance with the MCP addon actively listening on localhost:9876, meaning the application must already be open.