Create your account
Sign in, choose a plan, and keep the same account for the web dashboard and desktop app.
Blender Agent Docs
Start building Blender scenes with your AI agent.
Use this guide to install the app, connect Blender, write useful prompts, manage your AI plan, and recover from common setup issues.
Install
Desktop app and account setup
Connect
Blender Connector and MCP server
Prompt
Scene requests and refinements
Manage
Models, quota, and subscription access
Quickstart
Go from install to first Blender task.
Follow these steps the first time you use Blender Agent. You can return to Settings later to refresh sign-in, connector, and quota state.
Install the desktop app
Download Blender Agent, open it, and complete the first-run sign-in flow.
Connect Blender
Let the app install the Blender Agent Connector, then open or restart Blender so the connector can enable.
Describe the work
Ask for a scene, edit, material, light setup, camera move, or render pass in plain language.
Requirements
Check the basics before setup.
Blender Agent needs a supported Blender install, a desktop build, account access, and quota before AI requests can run.
Blender 5.1 or newer installed and opened at least once.
Windows or Mac Apple Silicon desktop app build from the Download page.
Internet access for sign-in, subscription checks, model access, and updates.
An active Blender Agent subscription plan with available quota.
Blender Setup
Keep Blender and the desktop app connected.
Blender Agent works through a local connector. The app can install it for you, check its status, and restart the local server when the connection changes.
Open the desktop app and sign in.
Go to setup or settings and install Blender Agent Connector.
Open or restart Blender so the add-on can enable.
Restart the Blender MCP server if the status panel asks for it. The default local connector port is 6274.
Send a small test prompt such as: create a cube with orange material and area light.
Prompting
Write requests like art direction.
The best prompts name the object or scene, the desired style, constraints, materials, lighting, camera, and what should stay unchanged.
Example 01
“Create a modern lake house at night with warm interior lights, fog, and a cinematic camera angle.”
Example 02
“Add bevels and realistic brushed metal materials to the product model, then set up studio lighting.”
Example 03
“Turn this blockout into a cyberpunk alley with wet asphalt, neon reflections, signs, and background props.”
Usage
Manage models, skills, and quota.
Each AI request consumes quota based on the selected model and token usage. Built-in skills give you reusable starting points for common Blender workflows.
Use the model selector to choose an available Blender Agent model before sending a prompt.
Open the skills panel to start common workflows such as lighting setup, material work, or rendering tasks.
Check billing or settings when quota is exhausted, the plan expired, or AI access is disabled.
Save or duplicate important .blend files before asking the agent to run broad edits or scripts.
Troubleshooting
Fast fixes for common issues.
Most setup problems come from sign-in state, subscription access, Blender not being restarted after connector install, or a prompt that needs tighter constraints.
Blender is open but the app says the connector is missing.
Restart Blender after installing the connector. If it still fails, open Blender Preferences, check Add-ons, and enable Blender Agent Connector.
AI is disabled or the send button is blocked.
Confirm that you are signed in and that your subscription is active with available quota.
The MCP server cannot reach the Blender Connector.
Confirm Blender is running, the Blender Agent Connector add-on is enabled, and the local connector port is set to 6274 unless you intentionally changed it.
The result is too broad or not in the style you wanted.
Add constraints such as style, scale, camera angle, material references, lighting mood, and what should stay unchanged.