Blender Extension

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.

TLDR

Command

uvx blender-mcp

Requirement

Download Blender Application and Blender MCP Addon file

Configuration

info

Note that you'll need uv installed on your system to run this command, as it uses uvx.

1. Download Blender Application
2. Add Blender MCP Addon
   • Download the addon.py file from the Blender MCP repository.
   • Open Blender
   • Navigate to Edit > Preferences > Add-ons.
   • Click the down arrow, select install from disk, add the addon.py file you downloaded.
   • After installing, check the box to enable Blender MCP.
3. 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 CLI

1. Run the configure command:

goose configure

2. 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 
  └ 

3. 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
  └ 

4. Enter the command

  ┌   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
  └ 

5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s

┌   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
│
└ 

6. Choose No when 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
 │    
 ◆  Would you like to add environment variables?
 │  No
 |
 └  Added blender extension

Goose Desktop

1. Launch the installer
2. Press Yes to confirm the installation
3. Click Save Configuration
4. Scroll to the top and click Exit from the upper left corner

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

CLI

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 ───

2. Now let's create the logs in a circle:

─── Execute Blender Code ───

3. Let's create the glowing fireball in the middle:

─── Execute Blender Code ───

Let me fix the fireball material:

─── Execute Blender Code ───

4. 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:

1. A large ground plane with a dark brown material
2. 5 logs arranged in a circle, with a rough wood material
3. A glowing fireball in the center with emission material
4. A point light to create the fire's glow effect
5. Adjusted the main sun light to create a warm sunset atmosphere
6. Positioned the camera for a dramatic angle
7. 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