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.