blender-mcp

Send remote commands to a live Blender instance for scene creation and modification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually operating Blender by letting Hermes programmatically drive a running Blender session to create and modify 3D content on demand.

Core Features & Use Cases

  • Blender Scene Control Over MCP: Sends JSON commands over TCP to a socket server running inside Blender.
  • Arbitrary bpy Execution: Runs Blender Python (bpy) code to implement custom creation, edits, and automation logic.
  • Introspection and Capture: Retrieves scene/object details and captures viewport screenshots for verification or downstream use.

Use case: You need to generate a product visualization and render updates quickly—use the Skill to create geometry, assign materials, and run tailored bpy code that matches your design parameters.

Quick Start

Start the Blender MCP addon server in Blender, then ask the assistant to execute bpy Python code to add or modify the scene through TCP port 9876.

Frequently Asked Questions about blender-mcp

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

FAQPage Schema
How do I automate Blender scene creation remotely from an assistant?

You can automate Blender scene creation by sending JSON commands over a TCP socket to a running Blender 4.3+ instance, executing Python code to generate meshes and materials without manual operation.

Can I run Blender Python bpy code through an MCP connection?

Yes, you can execute arbitrary Blender Python bpy code through the MCP connection by sending execute_code commands over TCP port 9876 to the active Blender session to automate custom creation and editing logic.

Do I need a specific Blender version to use TCP socket automation?

Yes, Blender 4.3 or higher is required. You must have the Blender desktop session running with the blender-mcp addon active as a TCP JSON socket server on port 9876 to receive commands.

What's the best way to capture a Blender viewport screenshot programmatically?

To capture a Blender viewport screenshot programmatically, send a get_viewport_screenshot command via the TCP socket connection to the running Blender instance, which returns the viewport image for verification or downstream use.

How do I extract scene and object information from Blender remotely?

You can extract scene and object information by sending get_scene_info or get_object_info JSON commands over the TCP socket to the live Blender session, retrieving detailed scene and object data for downstream automation.

Can I use this Blender automation approach for keyframe animations?

Yes, you can use this Blender automation approach to keyframe animations by sending tailored bpy Python code through the execute_code command over the TCP socket to modify and animate objects in the live scene.