blendrelay-mcp

BlendRelay MCP is an open-source Blender AI add-on and MCP server that enables prompt-based 3D modeling, scene generation, Edit Mode changes, reference images, and viewport sketches. It brings AI 3D modeling and text-to-Blender workflows into Blender 4.5+. Users connect an MCP-compatible AI agent such as Codex, Claude Code, or Antigravity, describe what they want, attach design references, sketch over the viewport, or target selected objects and mesh elements. The agent can then inspect and update the open .blend scene through typed Blender tools.

The tool supports generating complete scenes, environments, props, buildings, products, and abstract artwork, as well as editing selected objects with natural-language instructions. It can work with selected vertices, edges, and faces in Blender Edit Mode, use one or more reference images for shape, composition, material, or style guidance, and allow drawing viewport sketches and adjustable target boxes to show where changes should happen. It also creates materials, lighting, cameras, modifiers, Geometry Nodes, animation, and renders, and saves and restores automatic scene checkpoints if a result needs to be undone.

Installation requires Blender 4.5 or newer, uvx or Python 3.11+ with pip, and one supported AI command-line agent installed and signed in. Setup creates local runtime folders and installs the bundled Blender extension into the newest compatible Blender installation. The add-on is enabled in Blender's preferences, and users connect their AI agent through the BlendRelay panel. BlendRelay stores shared runtime data under a local application data directory, with each Blender scene receiving its own folder for references, agent logs, screenshots, sketches, and scene versions.