3D MCP Cursor Visualization
Blender MCP Logo - AI-Powered Development Tool for Cursor IDE

Blender MCP

Model Context Protocol Integration

Overview

BlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

Blender Features

  • Two-way communication between Claude AI and Blender
  • Object manipulation (create, modify, delete 3D objects)
  • Material control (apply and modify materials and colors)
  • Scene inspection (get detailed information about the current scene)
  • Code execution (run arbitrary Python code in Blender)
  • Poly Haven asset integration (HDRIs, textures, models)

Blender Setup & Configuration

Requirements

  • Blender 3.0 or newer
  • Python 3.10 or newer
  • uv package manager
  • Claude Desktop or Cursor

Installation Instructions

# UV Installation
uvx blender-mcp

# Installing the Blender Addon
1. Download the addon.py file from the repository
2. Open Blender
3. Go to Edit > Preferences > Add-ons
4. Click "Install..." and select the addon.py file
5. Enable the addon by checking the box next to "Interface: Blender MCP"

Configuration

# Claude Desktop Configuration
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

# Cursor Integration
Run blender-mcp without installing it permanently through uvx. Go to Cursor Settings > MCP and paste this as a command:
uvx blender-mcp

Blender Available Tools

  • get_scene_info
  • get_object_info
  • create_primitive
  • set_object_property
  • create_object
  • modify_object
  • delete_object
  • set_material
  • execute_blender_code
  • get_polyhaven_categories
  • search_polyhaven_assets
  • download_polyhaven_asset

Blender Required Inputs

Poly Haven Integration

Type
boolean
Description
Enable Poly Haven asset integration (optional)
Required
No

Blender Use Cases

  • AI-assisted 3D modeling and scene creation
  • Low-poly scene generation from text descriptions
  • Material and lighting setup
  • Converting reference images to 3D scenes
  • Automating repetitive modeling tasks
  • Importing assets from Poly Haven
  • Exporting scenes for web (ThreeJS) or other platforms

Frequently Asked Questions

BlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.
Blender 3.0 or newer, Python 3.10 or newer, uv package manager, Claude Desktop or CursorView detailed requirements
Follow the installation instructions in the setup section above.View installation guide

Blender MCP provides the following tools:

  • get_scene_info
  • get_object_info
  • create_primitive
  • set_object_property
  • create_object
  • modify_object
  • delete_object
  • set_material
  • execute_blender_code
  • get_polyhaven_categories
  • search_polyhaven_assets
  • download_polyhaven_asset