Skip to content

nousresearch/blender

v0.1.0MIT

Connect Hermes to the official Blender Lab MCP server and load a Blender workflow skill. Blender 5.1+ and its MCP add-on must be configured separately.

GitHub

Blender integration for Hermes

A portable Hermes plugin containing MCP launch configuration and a workflow skill for the official Blender Lab MCP server.

Install

hermes plugins install NousResearch/hermes-plugin-blender
hermes plugins enable blender

Choose the destination profile with the global hermes -p <profile> option. Catalog installation by the short name blender becomes available only after its catalog entry is merged and published.

Prerequisites

  • Blender 5.1 or newer on the same machine as the Hermes backend.
  • The official Blender Lab MCP add-on installed and enabled in Blender, with Online access enabled and its bridge started on loopback port 9876.
  • Git and uv available to the backend. Network access is required for the initial MCP environment setup.

See setup and troubleshooting. Installing this package does not install Blender, change Blender preferences, install its add-on, or open a scene.

Prepare the server before first activation

The first upstream download/build took several minutes in our Windows checks. Warm its isolated uv environment before asking Hermes to connect, so a normal MCP connection timeout does not interrupt the download:

uv tool run --from "git+https://projects.blender.org/lab/blender_mcp.git@2cea8d566dde07fbac28a61d698909d69724e853#subdirectory=mcp" blender-mcp --help

Restart Hermes, or use the explicit plugin/MCP reload commands supported by your release. The package's skill is available through skills_list and its qualified name via skill_view. Verify a real get_objects_summary response before treating Blender as ready.

What runs

Hermes launches the official server over stdio with the same pinned source as the preparation command. The MCP server connects to the Blender add-on over 127.0.0.1:9876. No native Hermes Python hooks, tool overrides, desktop JavaScript or self-updater are included.

The upstream revision is fixed to 2cea8d566dde07fbac28a61d698909d69724e853 (v1.0.3). uv resolves its Python dependencies in an isolated tool environment; those transitive dependencies are not fully locked by this package.

Security and licensing

Blender Lab warns that its tools execute arbitrary Python in Blender without protection against file deletion or data exfiltration. Use only with trusted workflows, keep the bridge loopback-only, and prefer a disposable scene or isolated machine for experiments. This is not a sandbox.

This uses Blender Lab's source on projects.blender.org, not the unrelated PyPI package with the same blender-mcp name. Do not substitute an unqualified package install.

The wrapper configuration and original documentation are MIT-licensed. The external Blender Lab server and add-on remain GPL-3.0-or-later, owned by their respective authors. No Blender Lab code is vendored here.

Verified scope

See verification. Headless scene read/create/transform/readback/delete passed on Windows ARM64 and x64 with Blender 5.2.2 LTS. Graphical screenshots, deferred operations, and automatic application/version/liveness detection are not verified or implemented by this wrapper. MCP tool listing alone does not establish scene readiness.