blender-mcp

Control a running Blender instance via socket bridge to automate scene creation and editing.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/zerwiz/wayofpi --skill blender-mcp-zerwiz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/zerwiz/wayofpi/tree/main/.hermes/hermes-agent/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/zerwiz/wayofpi --skill blender-mcp-zerwiz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of switching between an AI assistant and Blender by letting you drive a live Blender session directly from Hermes.

Core Features & Use Cases

  • Scene Control: Create, inspect, and modify objects in an active Blender scene through a socket-based command bridge.
  • Materials and Animation: Build materials, adjust shading, and keyframe motion for modeling and animation workflows.
  • Custom bpy Execution: Run arbitrary Blender Python code for advanced automation, diagnostics, and one-off production tasks.
  • Use Case: Use this Skill when you need to generate a 3D object, assign a material, animate it, or inspect the current viewport without leaving your AI workspace.

Quick Start

Ask the assistant to connect to the running Blender MCP server and create or modify the scene you want in the open Blender instance.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I automate 3D modeling and scene editing in Blender from an AI assistant?

You can automate 3D modeling and scene editing by using a socket bridge to control a running Blender instance, enabling you to create objects, set up materials, and adjust scenes directly from your AI workspace.

What do I need to control a live Blender session through a socket connection?

To control a live Blender session, you need Blender 4.3 or later with the Blender MCP addon installed, the server started in the viewport sidebar, and TCP access on port 9876 for JSON command exchange.

Can I run custom bpy scripts in Blender through an external AI command?

Yes, you can run arbitrary Blender Python code for advanced automation and diagnostics by sending custom bpy execution commands through the socket bridge to your active Blender session.

How do I keyframe animation and build materials in Blender without leaving my AI workspace?

You can keyframe animation and build materials by instructing the AI assistant to send JSON commands over the socket connection, adjusting shading and applying motion directly to the active scene.

Does this Blender socket control approach work for inspecting the current viewport?

Yes, this socket control approach supports viewport inspection, allowing you to check the current state of your 3D scene and objects without manually switching back to the Blender interface.

Why is my Blender MCP connection failing to execute scene commands?

Blender MCP scene commands fail when the addon server is not started in the viewport sidebar or when TCP access on port 9876 is blocked, preventing the JSON command exchange required for automation.