Blender Agent Bridge

Safe scene bridge for external AI agents

Blender Agent Bridge is a safe, provider-neutral bridge between Blender and external AI agents. Blender executes bounded helper tools, visual evidence capture, previews, binary script trust, checkpoints, and the local MCP bridge; external clients host the model and conversation.

Two aircraft in a Blender dogfight test scene with smoke and motion blur

1. Install the Blender extension

  1. Open Blender 4.2.0 or newer.
  2. Open Edit > Preferences > Get Extensions.
  3. Add a remote extension repository with this URL:
https://callmejones.github.io/blender-agent-bridge/index.json
  1. Sync the repository, search for Blender Agent Bridge, then install and enable it.
  2. Open the 3D View sidebar, start the bridge, and copy the MCP config for your external client.

2. Choose the MCP runtime

Bundled (default)

Press Copy MCP Config and paste it into your MCP client. The server is shipped with the extension, requires no extra installation, and keeps the default config compact.

uvx / PyPI (optional)

Install uv, select uvx / PyPI in Blender preferences, then copy the config. It pins the matching release:

uvx --from blender-bridge==0.5.6 blender-bridge

Windows configs use cmd /c uvx. Blender never installs software automatically.

Run only one MCP server instance against a Blender bridge. Both modes use the same protocol, canonical registry digest, tool contracts, and safety gates. Incompatible protocol or digest combinations fail closed.

Safety by design

Bounded tools first

Structured helpers cover routine scene work. Generated Python runs only while binary session trust is active.

Reversible editing

Mutating helpers use visible preview transactions with commit, revert, and Blender undo paths.

Local and inspectable

The bridge binds to loopback, redacts audit data, exposes status and evidence resources, and stores no model-provider keys.

Client guides

Codex Claude Cursor VS Code / Cline / Roo ChatGPT Gemini CLI OpenCode Ollama hosts

Showcase

Three frames showing planning, visual evidence, and repair in the Egypt dogfight workflow

This documented test workflow used scene inspection, helper previews, playblast/render evidence, repairs, and background rendering. Media is documentation-only; read its provenance and licensing boundary.

Curated showcase and submission guide

Manual install fallback

Download the packaged extension ZIP from the latest GitHub release, then use Blender's Install from Disk. Do not install GitHub's generated source-code ZIP.

Current package

Latest package: claude_blender-0.5.6.zip (0.5.6)

Archive hash: sha256:b16756274c26f64c34c4e78f4d68e09753068445817566d10414411d7b48efb7

Project: https://github.com/CallMeJones/blender-agent-bridge

Discussions · Issues · Contributing · Support