Give your AI coding agent direct access to your live Blender scene.
Blender Bridge is a lightweight Blender addon that opens a local HTTP server so any coding agent can execute Python in your running Blender session. No MCP server, no Node.js, no helper scripts. Install the addon, toggle it on, and your agent has full bpy API access.
- Download the zip from Releases
- In Blender: Edit > Preferences > Add-ons > Install — select the zip
- Enable Blender Bridge in the addon list
- Click the bridge icon in the top-right of the top bar to start the server
- Ctrl+Click the same icon to copy the agent instructions to your clipboard
- Paste those instructions into your coding agent's context (chat, project docs, etc.)
- Your agent can now talk to Blender
That's it. The agent instructions tell your coding agent everything it needs to know about the HTTP protocol, safety rules, and Blender-specific gotchas.
curl -X POST http://localhost:9876 -d 'print(bpy.data.objects.keys())'The addon ships with two instruction files that get copied to the agent's context:
| File | Purpose |
|---|---|
agent_instructions.md |
Global instructions shared with every agent. Covers the HTTP protocol, safety rules, tips, and gotchas. Edit with care — changes affect all agents. |
agent_instructions.local.md |
Optional. Your personal preferences, project-specific prompts, or extra context. Create this file in the addon folder to append to the global instructions. Not tracked by git. |
In Edit > Preferences > Add-ons > Blender Bridge:
| Setting | Default | Description |
|---|---|---|
| Port | 9876 |
HTTP port (restart bridge to apply) |
| Timeout | 60s |
Max execution time per command |
- Localhost only — not designed for remote access
- Sequential — one command at a time
- Blocking code freezes Blender — time-intensive scripts or operations may temporarily freeze Blender's UI until completion. A "Not Responding" window title often just indicates a background process is still running
- Security — runs
exec()on received code; only use on trusted machines
Created by Walker Nosworthy | MIT License