blender-mcp

Execute bpy code and manage scene objects in Blender over TCP.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables remote control of a running Blender instance from Hermes, allowing automation of 3D tasks by sending bpy commands over a TCP socket.

Core Features & Use Cases

  • Remote command execution: send arbitrary bpy code to a running Blender instance and receive results.
  • Scene management: create and modify objects, apply materials, and animate scenes programmatically from Hermes.
  • Protocol & integration: operate via a simple JSON over TCP protocol on port 9876, enabling end-to-end Blender automation in integrated workflows.

Quick Start

Launch the Blender MCP server in Blender and connect Hermes to localhost:9876 to start sending JSON commands.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I run Python scripts in Blender remotely from another application?▼

Remote Blender automation works by sending JSON commands over a TCP socket on port 9876. You launch a Blender addon server inside Blender, then connect Hermes to localhost:9876 to start sending commands like execute_code and get_scene_info.

How does remote scene management and object creation work with Blender?▼

Remote scene management works by sending JSON formatted bpy commands over a TCP socket. You can programmatically create and modify 3D objects, apply materials, and animate scenes from Hermes, receiving execution results back over the same connection.

What do I need to set up before automating Blender tasks via a TCP socket?▼

Before automating Blender tasks, you need a running Blender instance with the MCP addon server launched. You then connect your client environment, Hermes, to localhost on port 9876 to establish the JSON over TCP communication channel.

Can I use this to get scene and object info from Blender programmatically?▼

Yes, you can get scene and object info from Blender programmatically using supported protocol commands. The socket integration supports get_scene_info and get_object_info commands, allowing you to retrieve current scene data and specific object details remotely.

Are there limitations to running bpy code remotely over a TCP socket in Blender?▼

A key limitation of running bpy code remotely over a TCP socket is that it requires a continuously running Blender instance with the addon server active. It depends on a stable localhost network connection on port 9876 to execute commands and manage scene objects.