Installation

Install the package, enable the add-on, connect Blender.

BlendRelay setup installs the local runtime and bundled Blender extension. Your preferred AI command-line agent must be installed and signed in separately.

Before you install

Blender 4.5 or newer. Open Blender once before setup.
uvx, or Python 3.11+ with pip.
One supported installed and signed-in agent: Codex CLI, Claude Code or Antigravity CLI.

Recommended setup

uvx blendrelay-mcp setup

Or install with Python:

python -m pip install blendrelay-mcp
blendrelay-mcp setup

To target Blender 4.5 specifically:

uvx blendrelay-mcp setup --blender-version 4.5

Enable BlendRelay in Blender

Restart Blender after setup.
Open Edit → Preferences → Add-ons / Get Extensions.
Search for BlendRelay MCP and enable it.
Return to the 3D Viewport and press N.
Choose the BlendRelay tab and select Connect.

Check the installation

uvx blendrelay-mcp doctor

If Blender remains disconnected, open the troubleshooting guide.

Open BlendRelay on PyPI