skills.rest
Chensihakniroth
ChensihaknirothCOMMUNITY
Explore all skills by this author →
GitHub

blender-mcp

Control Blender over a TCP socket to create 3D objects, materials, and animations via bpy.

Updated Jun 7, 2026
Search Tags:#rendering#MCP#animation#3D modeling#Blender#socket#bpy
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill blender-mcp-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill blender-mcp-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating and modifying 3D scenes in Blender normally requires manual GUI work or writing standalone scripts, making it hard to drive Blender programmatically from an AI agent during a conversation. ## Core Features & Use Cases - Remote Blender Control: Send JSON commands over TCP port 9876 to a running Blender instance with the blender-mcp addon enabled. - Arbitrary bpy Execution: Run any Blender Python code to create meshes, assign materials, insert keyframes, and render stills to file. - Scene Inspection: Query scene and object information and capture viewport screenshots to verify results. - Use Case: Ask the agent to build a scene with a sphere, cube, and cylinder, apply a metallic blue material, animate the sphere rising over 60 frames, and render the result to /tmp/render.png. ## Quick Start Install the blender-mcp addon in Blender, start its socket server from the N-panel, then ask the agent to create a 3D scene in Blender and render it to a PNG file.

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 from Python remotely?▼

Install the blender-mcp addon in Blender, start its socket server from the N-panel sidebar, then send JSON commands over TCP port 9876. The execute_code command runs arbitrary bpy Python code inside the running Blender instance.

How to create 3D objects and materials in Blender with bpy?▼

Use bpy.ops.mesh primitives like primitive_uv_sphere_add or primitive_cube_add to create objects. Create materials with bpy.data.materials.new, enable nodes, and set Base Color, Roughness, and Metallic on the Principled BSDF node.

Does blender-mcp work with headless Blender?▼

No, blender-mcp requires a desktop Blender 4.3+ instance because the addon server must be started manually from the viewport N-panel. Headless Blender sessions are not supported by this socket-based approach.

Why is the Blender socket connection refused on port 9876?▼

The connection fails when the addon server is not running inside Blender. Open the N-panel sidebar, find the BlenderMCP tab, and click Start Server, then verify with nc -z localhost 9876 before sending commands.

What are the limitations of executing bpy code over a socket?▼

Complex scenes should be split into multiple smaller execute_code calls to avoid socket timeouts. Render output paths must be absolute, and operations like shade_smooth require the object to be selected and in object mode.

Related Skills

Explore More Design & Creative Skills→
MLT-OSSMLT-OSS
14

blender-mcp

Controls Blender over a TCP socket to create 3D objects, materials, and animations via bpy code.

Official
Intermediate
TeamWiseFlowTeamWiseFlow
8.5k

manim-explainer

Renders Manim animation scenes into MP4 explainer videos with thumbnail frames.

Official
Intermediate
carterwayneskhizeinecarterwayneskhizeine
19

blender-mcp

Control a running Blender instance via TCP JSON commands.

Community
Intermediate
flaz78flaz78
9

blender_skill

Automate Blender scene creation and rendering via JSON actions.

Community
Advanced