blender-mcp

Control a running Blender instance over a TCP socket with JSON commands.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/jacardl/New-Radar --skill blender-mcp-jacardl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/jacardl/New-Radar/tree/main/backend/frameworks/hermes-agent/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/jacardl/New-Radar --skill blender-mcp-jacardl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable programmatic control of a running Blender instance from Hermes, allowing creation and modification of 3D objects, materials, and animations through a socket-based interface.

Core Features & Use Cases

  • Remote orchestration of Blender scenes via the MCP addon with a simple JSON protocol.
  • Execute arbitrary bpy code, query scene information, and retrieve viewport data to drive automated workflows.
  • Ideal for rapid prototyping, education, and pipeline automation where Blender is driven by AI agents.

Quick Start

Start the Blender MCP server, connect Hermes to localhost:9876, and send a JSON command to execute_code or query scene data.

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 over a TCP socket by using this skill to send plain UTF-8 JSON commands to a running Blender instance, executing bpy code and modifying 3D objects directly.

Can I execute arbitrary bpy code in Blender from an external script?

Yes, you can execute arbitrary bpy code in Blender from an external script by sending an execute_code command via the TCP socket protocol, allowing you to create and modify 3D objects and apply materials programmatically.

How does an AI agent query scene information from a running Blender instance?

An AI agent queries scene information from a running Blender instance by sending JSON requests like get_scene_info or get_object_info over a TCP socket, retrieving viewport data and 3D object details to drive automated workflows.

Do I need a specific Blender addon to enable socket-based automation?

Yes, you need to start the Blender MCP server addon to enable socket-based automation, which listens on localhost:9876 and accepts JSON commands to orchestrate 3D scenes and execute bpy code.

What is the best way to automate 3D scene creation and animation in Blender programmatically?

The best way to automate 3D scene creation and animation programmatically is using this socket interface, which allows you to send JSON commands to apply materials, animate scenes, and execute arbitrary bpy code across a Blender session.

Can I retrieve viewport screenshots from Blender via a socket connection?

Yes, you can retrieve viewport screenshots from Blender via a socket connection by sending the get_viewport_screenshot command, which returns viewport data over the TCP socket to support automated pipeline workflows.