Blender

BlenderMCP lets you connect Blender to Claude AI using the Model Context Protocol (MCP). This enables prompt-driven 3D modeling, scene creation, and manipulation directly from Claude, while Blender executes the requested actions in real time.

How to use

You connect Blender to Claude through a local MCP server that runs alongside Blender. With the server active, you can ask Claude to inspect the current scene, create, modify, or delete objects, apply materials, run Python code inside Blender, and fetch assets from Poly Haven or generate models via Hyper3D Rodin. Use the Blender MCP controls in the 3D Viewport sidebar to establish the connection and start exchanging commands.

How to install

Prerequisites you need before you begin:

- Blender 3.0 or newer
- Python 3.10 or newer
- uvx package manager (required) — install it before proceeding

Install uvx (examples shown):
- macOS: install uvx via Homebrew
- Windows: install uvx as part of the uvx setup script

Install the Blender MCP addon and run the MCP server as described below.

Step-by-step commands to set up the MCP environment and connect Blender to Claude are provided in the following configuration snippet. Use this exact setup in your environment once you have uvx installed.

Configuration and usage details

{
  "mcpServers": {
    "blender": {
      "type": "stdio",
      "name": "blender",
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  },
  "envVars": []
}

Using with Claude

Ensure the Blender addon is installed and running, then configure Claude to connect to the local MCP server. You will see a hammer icon in Claude’s interface with tools for Blender MCP when the connection is active.

Capabilities

• Get scene and object information
• Create, delete and modify shapes
• Apply or create materials for objects
• Execute any Python code in Blender
• Download models, textures, and HDRIs through Poly Haven
• AI generated 3D models through Hyper3D Rodin

Example workflows

Ask Claude to build a scene, then refine lighting, camera angles, and materials. Request assets from Poly Haven or generate a model with Hyper3D Rodin, and have Claude place and configure objects in Blender accordingly.

Hyper3D integration

Hyper3D provides a trial key with a limited daily quota. You can upgrade to your own key to remove the limit.

Troubleshooting

- Connection issues: Ensure the Blender addon server is running and the MCP server is configured on Claude. Do not run the uvx command in the terminal if you are using the integrated clients.
- Timeout errors: Break requests into smaller steps or simplify prompts
- Poly Haven: Behavior can be inconsistent; try toggling the integration off and on again
- If issues persist, restart both Claude and the Blender server to reset the connection.

Technical details

The system uses a simple JSON-based protocol over TCP sockets. Commands are JSON objects with a type and optional params; responses are JSON objects with status and result or message.

Security and best practices

The execute_blender_code capability can run arbitrary Python inside Blender. Use this only in trusted environments and always save work beforehand. Enable and disable Poly Haven integration as needed to manage assets securely.

Notes

Only one MCP server instance should run in your environment at a time. Use the designated MCP server configuration for Blender to ensure stable connections.

Available tools

get_scene_info

Retrieve detailed information about the current Blender scene, including objects, materials, and camera setup.

create_object

Create a new 3D object in the Blender scene with specified type and properties.

modify_object

Modify properties of an existing object, such as transformation, scale, or material.

delete_object

Delete an object from the Blender scene.

apply_material

Apply or modify materials and colors on objects.

execute_blender_code

Run arbitrary Python code inside Blender from the MCP client.

download_poly_haven_assets

Download models, textures, and HDRIs from Poly Haven for use in the scene.

hyper3d_generate

Generate AI-assisted 3D models via Hyper3D Rodin integration.