Blender integration for Hermes
Part of Hermes Official Plugins, Nous Research's official plugins for Hermes Agent. Formerly
NousResearch/hermes-plugin-blender, which is archived; this directory carries its full history.
A portable Hermes plugin containing MCP launch configuration and a workflow skill for the official Blender Lab MCP server.
Install
hermes plugins install 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. Hermes checks for it before installing and refuses the install when it is missing: on Windows the
Blenderuninstall entry's install folder or%ProgramFiles%/Blender Foundation/Blender */blender.exe; on macOSBlender.appin/Applications,~/Applicationsor the Steam library; on LinuxblenderonPATH, theorg.blender.Blenderflatpak, theblendersnap or the Steam library (native or flatpak Steam). Linux has no version source, so the 5.1 minimum is checked on Windows and macOS only. This needs a Hermes release that reads location lists inapp:declarations. - 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.
- Optional, for the
*_for_clitools that open a saved.blendfile in a separate background Blender: ablendercommand on the backend'sPATH.BLENDER_PATHset in a shell or.envdoes not reach the server.
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 liveness detection (whether Blender and its bridge are running) are not verified or implemented by this wrapper. MCP tool listing alone does not establish scene readiness.
