blender-mcp

Control Blender by executing bpy Python code over a TCP socket connection.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/thisismynewfmail-ui/Monika-agent --skill blender-mcp-thisismynewfmail-ui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-mcp
Source: https://github.com/thisismynewfmail-ui/Monika-agent/tree/main/optional-skills/creative/blender-mcp
Command: npx skills add https://github.com/thisismynewfmail-ui/Monika-agent --skill blender-mcp-thisismynewfmail-ui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Monika cannot directly manipulate Blender, forcing users to switch contexts or write separate scripts to create or edit 3D content.

Core Features & Use Cases

  • Execute arbitrary Blender Python (bpy) code from Monika.
  • Retrieve scene and object information, and capture viewport screenshots.
  • Automate modeling, material assignment, animation keyframing, and rendering through simple socket commands.

Quick Start

Ask Monika to add a UV sphere at the origin in Blender.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I execute Blender Python bpy code from an external script or assistant?

You can execute arbitrary Blender Python bpy code by establishing a socket connection to an active Blender instance. This allows external systems like Monika to send commands and automate 3D tasks directly within the running session.

Can I capture Blender viewport screenshots through an automated socket connection?

Yes, capturing viewport screenshots is supported through the socket connection. By sending the appropriate command via the socket server, you can retrieve visual feedback of the current 3D scene from the active Blender instance.

What do I need to automate Blender 3D modeling via a socket server?

To automate 3D modeling via a socket server, you need a running Blender instance with the blender-mcp addon installed. The socket server must be actively started on TCP port 9876 to accept incoming automation commands.

Does Monika work with Blender for automating 3D scene creation and material assignment?

Monika works with Blender to automate 3D scene creation, material assignment, and animation keyframing. It connects via a socket interface to execute bpy Python code and retrieve scene data without requiring manual context switching.

Why does my socket connection to Blender fail when executing bpy code?

Your socket connection to Blender fails if the blender-mcp addon is not installed or the socket server is not started. Ensure your active Blender instance is running and listening on TCP port 9876 before sending bpy code commands.

What are the limitations of controlling Blender via a socket connection?

The primary limitation of controlling Blender via a socket connection is the absolute dependency on an active Blender instance. If the application is closed or the socket server on TCP port 9876 is stopped, all 3D automation and bpy code execution will fail.