Skip to content

feat(skills): add blender-mcp skill for 3D modeling and animation#1354

Closed
alireza78a wants to merge 2 commits into
NousResearch:mainfrom
alireza78a:feat/blender-mcp-skill
Closed

feat(skills): add blender-mcp skill for 3D modeling and animation#1354
alireza78a wants to merge 2 commits into
NousResearch:mainfrom
alireza78a:feat/blender-mcp-skill

Conversation

@alireza78a

Copy link
Copy Markdown
Contributor

feat(skills): add blender-mcp skill for 3D modeling and animation

Adds a new skill that teaches Hermes to control Blender directly via
the blender-mcp addon over a socket connection (port 9876).

What this enables

  • Create 3D objects, materials, and animations from natural language
  • Run arbitrary Blender Python (bpy) code
  • Get scene info and viewport screenshots

Demo

Hermes created this red sphere from a single natural language prompt:
demo

Setup

  1. Install blender-mcp addon in Blender
  2. Start socket server (N panel > BlenderMCP > Connect)
  3. Hermes connects automatically on port 9876

fix: update BlenderMCP button label to Start Server

### 1. Install the Blender addon

curl -sL https://raw.githubusercontent.com/ahujasid/blender-mcp/main/addon.py -o ~/Desktop/blender_mcp_addon.py

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it normal to point to a third party gist rather than include the script?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What version of blender should we be using?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good questions!

  1. The curl command points to the official blender-mcp addon repo by ahujasid — this is intentional since the addon is maintained there and users should always get the latest version. I can add a note recommending to verify the source before running.

  2. Tested on Blender 4.x (4.3+). I'll add the version requirement to the skill doc.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://pypi.org/project/bpy/ says the latest version of blender is pip install bpy==5.0.1 So I would assume Blender 5?

It's not great to be so new, but I'd expect that anything we choose will be old...

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh I missed that this is ran on a desktop vs a headless python.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, desktop only — needs the viewport running for the socket server and screenshots. Headless won't work.

Tested on 4.3+, will add that to the doc.

@teknium1

Copy link
Copy Markdown
Contributor

Moved to optional-skills/creative/blender-mcp/ in PR #1531 (authorship preserved). Great skill — well-structured with protocol docs, Python helper, and pitfalls section. Placed in optional-skills since it requires a running Blender desktop instance with a manually-started addon. Thanks, @alireza78a!

@teknium1 teknium1 closed this Mar 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants