blender-mcp

Control a running Blender instance via JSON-over-TCP commands.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/JKhyro/HERMES-AGENT --skill blender-mcp-jkhyro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/JKhyro/HERMES-AGENT/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/JKhyro/HERMES-AGENT --skill blender-mcp-jkhyro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of switching between Hermes and Blender by letting you control a live Blender session directly from the agent.

Core Features & Use Cases

  • 3D Scene Control: Create, inspect, and modify objects in a running Blender scene.
  • Materials and Animation: Build materials, keyframe motion, and render results from remote instructions.
  • Direct Python Access: Run arbitrary bpy code for custom modeling, automation, and scene manipulation.
  • Use Case: A user can ask for a product mockup, a simple animated logo, or a scene cleanup and have Hermes drive Blender to produce it interactively.

Quick Start

Ask Hermes to connect to your running Blender instance and create or edit the scene you want using the Blender MCP socket server.

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 from an AI agent?

You can control a running Blender instance by sending JSON-over-TCP commands through the blender-mcp addon server, enabling the agent to execute bpy code and manipulate scene state in real time.

Can I run arbitrary Python bpy code in Blender remotely?

Yes, you can run arbitrary bpy code remotely by sending execute_code commands over the TCP socket, allowing custom modeling and scene automation without switching between applications.

Do I need a specific Blender version to use MCP socket control?

Yes, MCP socket control requires Blender 4.3 or later with the addon server running on TCP port 9876 to accept execute_code commands and scene queries.

What 3D tasks can I automate through a Blender MCP connection?

Through a Blender MCP connection, you can automate 3D scene creation, object modification, material building, keyframe animation, and interactive rendering directly from the agent.

Why is my Blender MCP connection not working on port 9876?

Your Blender MCP connection fails if the addon server is not running on TCP port 9876, or if your Blender version is older than 4.3, which is required for the JSON-over-TCP protocol.