# Generate a 3D scene in Blender from a prompt

> Blocking out a 3D scene by hand is slow when you just want to explore an idea.

This setup is for 3D artists, designers and hobbyists who want to block out scenes in Blender by describing them. The community Blender MCP server lets Claude inspect your scene, run Python inside Blender and pull in assets from sources such as Poly Haven. You end up with an editable Blender scene you can keep refining by hand or by prompt.

## Steps

1. **Install the Blender add-on**: Download addon.py from the blender-mcp project, install it in Blender under Edit > Preferences > Add-ons, and enable it. Open the BlenderMCP tab in the 3D viewport sidebar (press N) and click Connect. Register the server in Claude Desktop's config or Claude Code with uvx blender-mcp, then ask Claude to describe the current scene.
   Tip: Install uv first; the server runs through uvx.
2. **Describe the scene**: Describe the objects, layout, materials, lighting and camera you want, for example a low-poly desk with a lamp, warm key light and a 50mm camera at eye level. Claude builds the scene with Python and can take viewport screenshots to check its work. Ask for one area at a time so you can correct early.
   Tip: Turn on Poly Haven in the add-on panel if you want real HDRIs and textures instead of flat colours.
3. **Refine and render**: Ask for changes in plain language, like make the lamp brass or move the camera left. When you are happy, render from Blender or ask Claude to set the render engine, resolution and output path. Save the .blend file yourself so you control versions.
   Tip: Save often; Ctrl+Z in Blender may not undo everything a script changed.

## Prompts to try

- Describe what is in the current scene and list the objects with their materials.
- Create a simple living room with a sofa, rug, coffee table and a window, lit by soft daylight.
- Add a Poly Haven studio HDRI and set the world lighting to use it.
- Make all the wooden objects darker walnut and add a slight roughness variation.
- Set the camera to 35mm, frame the coffee table and render a 1920x1080 image to the renders folder.

## What you need

- Blender installed locally
- uv installed to run the server with uvx
- Claude Desktop or Claude Code
- Optional accounts for asset or model services you enable

## Limits

- Scenes built from primitives look rough; detailed results need real assets or manual modelling.
- Claude judges layout through occasional screenshots, so proportions and placement often need correction.
- Complex scripts can be slow or crash Blender on large scenes.

## Security notes

- Community server that can run Python inside Blender. Use it on projects you've backed up.

## MCP servers

- [Blender MCP Server](https://github.com/ahujasid/blender-mcp): scene-read, scene-edit, run-python

## FAQ

**Is Blender MCP safe?**

The server can run any Python code inside Blender, which can also read and write files on your computer. Use it on backed-up projects, read the add-on code, and keep tool approvals on for code execution.

**Which Blender version do I need?**

Use a recent Blender release supported by the add-on; the project README lists tested versions. Python APIs change between versions, so older releases can fail.

**Can it generate custom 3D models?**

The add-on can connect to optional services such as Hyper3D Rodin, Hunyuan3D or Sketchfab when you enable them. Some of these need their own accounts or keys and have their own limits.

**Which Claude hosts work?**

Claude Desktop and Claude Code both work, and so do other MCP clients such as Cursor. Blender must be running with the add-on connected.

## Tools

- **[Blender](https://suiteintent.com/t/blender?m=GB)**: Free, open-source 3D creation suite. · Best for: 3D work without paying for software · Free plan