Blender Extension
Watch the demo
This tutorial covers how to add the Blender MCP Server as a goose extension to create 3D scenes, control Blender with natural language, generate models, apply materials, and more.
- goose Desktop
- goose CLI
Command
uvx blender-mcp
Requirement
Download Blender Application and Blender MCP Addon file
Configurationβ
Note that you'll need uv installed on your system to run this command, as it uses uvx.
- Download Blender Application
- Add Blender MCP Addon
- Download the
addon.pyfile from the Blender MCP repository. - Open Blender
- Navigate to
Edit>Preferences>Add-ons. - Click the down arrow, select
install from disk, add theaddon.pyfile you downloaded. - After installing, check the box to enable
Blender MCP.
- Download the
- Start Blender MCP server
- In Blender, press N to open the sidebar.
- Go to the Blender MCP tab.
- Click
connect to MCP server
Add Blender MCP Serverβ
- goose Desktop
- goose CLI
- Launch the installer
- Click
Yesto confirm the installation - Click the button in the top-left to open the sidebar
- Navigate to the chat
- Run the
configurecommand:
goose configure
- Choose to add a
Command-line Extension.
β goose-configure
β
β What would you like to configure?
β Add Extension
β
β What type of extension would you like to add?
β β Built-in Extension
β β Command-line Extension (Run a local command or script)
β β Remote Extension (SSE)
β β Remote Extension (Streaming HTTP)
β
- Give your extension a name.
β goose-configure
β
β What would you like to configure?
β Add Extension
β
β What type of extension would you like to add?
β Command-line Extension
β
β What would you like to call this extension?
β Blender
β
- Enter the command to run when this extension is used.
β goose-configure
β
β What would you like to configure?
β Add Extension
β
β What type of extension would you like to add?
β Command-line Extension
β
β What would you like to call this extension?
β Blender
β
β What command should be run?
β uvx blender-mcp
β
- Enter the number of seconds Goose should wait for actions to complete before timing out. Default is
300seconds.
β goose-configure
β
β What would you like to configure?
β Add Extension
β
β What type of extension would you like to add?
β Command-line Extension
β
β What would you like to call this extension?
β Blender
β
β What command should be run?
β uvx blender-mcp
β
β Please set the timeout for this tool (in secs):
β 300
β
- Enter a description for this extension.
β goose-configure
β
β What would you like to configure?
β Add Extension
β
β What type of extension would you like to add?
β Command-line Extension
β
β What would you like to call this extension?
β Blender
β
β What command should be run?
β uvx blender-mcp
β
β Please set the timeout for this tool (in secs):
β 300
β
β Enter a description for this extension:
β Blender 3D scene creation integration
β
- Choose
Nowhen asked to add environment variables.
β goose-configure
β
β What would you like to configure?
β Add Extension
β
β What type of extension would you like to add?
β Command-line Extension
β
β What would you like to call this extension?
β Blender
β
β What command should be run?
β uvx blender-mcp
β
β Please set the timeout for this tool (in secs):
β 300
β
β Enter a description for this extension:
β Blender 3D scene creation integration
β
β Would you like to add environment variables?
β No
β
β Added Blender extension
Example Usageβ
In this example, Iβll show you how to use goose with the Blender Extension to build an entire 3D campfire scene from scratch. By automating Blender controls through natural language, goose can create objects like logs and fireballs, apply realistic materials, add lighting effects, generate particles for sparks, create subtle smoke, and even animate the fire to gently pulse over time.
In this example, Iβll show you how to use goose with the Blender Extension to build a full 3D campfire scene, including logs, fireballs, lighting, and subtle fire animation, just by describing what you want.
goose Promptβ
Build a cozy campfire scene. Add a ground plane, place a few logs in a circle, and add a glowing fireball in the middle. Set the lighting to a warm tone like a sunset, and angle the camera for a dramatic shot. Give the logs a rough wood texture and make the fireball emit light.
goose Outputβ
I'll help you create a cozy campfire scene in Blender. Let's break this down into steps and use a combination of basic objects, textures from PolyHaven, and proper lighting. First, let's check what we're working with.
βββ Get Scene Info βββ
Let's build the scene step by step:
First, let's remove the default cube and set up our ground plane:
βββ Execute Blender Code βββ
- Now let's create the logs in a circle:
βββ Execute Blender Code βββ
- Let's create the glowing fireball in the middle:
βββ Execute Blender Code βββ
Let me fix the fireball material:
βββ Execute Blender Code βββ
- Finally, let's set up the lighting and camera for a dramatic sunset shot:
βββ Execute Blender Code βββ
I've created a cozy campfire scene with the following elements:
- A large ground plane with a dark brown material
- 5 logs arranged in a circle, with a rough wood material
- A glowing fireball in the center with emission material
- A point light to create the fire's glow effect
- Adjusted the main sun light to create a warm sunset atmosphere
- Positioned the camera for a dramatic angle
- Set up the scene for better rendering with Cycles
The scene has a warm, cozy atmosphere with the logs arranged naturally around the glowing fireball. The lighting simulates a sunset with warm tones, and the camera is positioned to capture the scene from an interesting angle.
If you'd like to make any adjustments, such as:
- Changing the size or position of any elements
- Adjusting the lighting intensity
- Modifying the camera angle
- Adding more details like small rocks or additional logs
Just let me know and I'll help you refine the scene further!
Blender Imageβ
