blender-mcp

Executes Blender Python code remotely via socket-based API for automation and control.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/ChimeraFoundationa/Agentx --skill blender-mcp-chimerafoundationa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/ChimeraFoundationa/Agentx/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/ChimeraFoundationa/Agentx --skill blender-mcp-chimerafoundationa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate live Blender sessions by exposing a socket-based API that lets Hermes execute arbitrary bpy code, modify scenes, and query scene information without manual GUI interaction.

Core Features & Use Cases

  • Remote execution of Blender Python (bpy) code over TCP with a simple JSON protocol.
  • Scene interrogation and manipulation: create objects, set materials, animate, and retrieve scene data such as object lists and viewport info.
  • Integrations for design workflows: automate asset creation, batch renders, and interactive prototyping driven by AI.

Quick Start

Start the Blender MCP server in Blender, then connect via TCP to localhost:9876 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 automate Blender with Python scripting from an external application?

You can automate Blender by running a TCP socket server on localhost:9876 that receives JSON commands and executes bpy code. This lets external clients manipulate scenes, apply materials, and animate objects without manual GUI interaction.

Can I control a live Blender session and retrieve scene data remotely?

Yes, controlling a live Blender session remotely is possible via a socket-based API that executes bpy code. It allows you to query scene information like object lists and viewport screenshots, and modify scenes in real time.

What do I need to set up before sending bpy commands to Blender over a socket?

You need a running Blender instance with the MCP server started, then connect via TCP to localhost:9876. Once connected, your client can send JSON commands to the defined endpoints to execute Python code.

Does Blender MCP work for batch rendering and automated asset creation?

Yes, Blender MCP supports batch renders and automated asset creation by exposing a TCP socket API. It allows you to execute arbitrary bpy code to automate design workflows and interactive prototyping driven by AI.

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

The TCP socket API requires a running Blender instance on localhost:9876 and a client capable of sending JSON commands. It relies on the local server being active, meaning it is designed for local automation rather than remote cloud execution.

What is the best way to integrate AI-driven prototyping with Blender?

The best way to integrate AI-driven prototyping is using a socket-based API to execute bpy code. This allows Hermes to automatically control Blender, modify scenes, and query scene information for interactive design workflows.